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System Generation provides the facilities for the creation and 
maintenance of a monitored system of ibm and user-supplied pro- 
grams. The end product of System Generation is a System 
Operating File, including a System Monitor, that is tailored to 
provide an efficient Operating System for a specific machine 
environment. 

This publication provides systems programmers and systems 
analysts with detailed information on the System Generation 
function. The publication describes the System Generation func- 
tion, the programs used, and — primarily by means of examples 
— the procedures required for both tape-oriented and disk- 
oriented systems. Also included are machine requirements, core- 
storage requirements, and timing information for the elements of 
the IBM 1410/7010 Operating System. The use of customer op- 
tions such as the History file and System Maintenance programs 
is also explained. 

Note: The ibm 1302 Disk Storage Unit is now designated the 
ibm: 2302 Disk Storage Unit; there has been no change in the 
unit itself, in the applications for which the unit may be used, 
or in the programming parameters used to specify those appli- 
cations. The IBM 2302 Disk Storage Unit designation has been 
used in the text of this publication; programming parameters 
remain unchanged and refer to 1302. 










Major Revision ( October 1965 ) 

This publication is a major revision of, and obsoletes, the pvib- 
lication IBM 1410/7010 Operating System; System Generation, 
Form C28-0352-4. The revision includes expanded discussions 
of Tele-processing System Requirements, Control Cards, Moni- 
tor Definitions, Symbolic Unit Definitions, and iocs Definitions. 
Changes to the text are indicated by a vertical line at the left 
of the affected text. 

Copies of this and other IBM publications can be obtained through IBM Branch Offices. 

Address comments concerning the contents of this publication to: 
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Introduction 



Purpose of this Publication 

This publication provides systems programmers and 
systems analysts with detailed information on the 
System Generation function provided for the 1410/ 
7010 Operating System. The use of a History file (a 
customer option ) is discussed, and maintenance of the 
file by use of the sg3 program is explained. 



Purpose of System Generation 

System Generation provides facilities for the genera- 
tion and maintenance of the ibm 1410/7010 Operating 
System, adapted to both the computer and the data 
processing requirements of an installation. 

System Generation is a function performed within 
and for the Operating System, using various Operat- 
ing System programs, under Monitor control. 



Prerequisite and Related Literature 

Prerequisite Literature 

For an understanding of the basic concepts of the 
Operating System, the reader is directed to: 
IBM 1410/7010 Operating System; Basic Concepts, 

Form C28-0318. 
For details on features, functions, and capabilities 
of the Operating System, the reader is directed to: 
IBM 1410/7010 Operating System; System Monitor, 
Form C28-0319. 

Related Literature 

The following ibm 1410/7010 Operating System pub- 
lications are not prerequisite in their entirety to the 
System Generation function, but are recommended 
reading for a general knowledge of the appropriate 
program or programming system to be generated and 
maintained. 

Basic Input/Output Control System, Form C28-0322 
Random-Processing Scheduler, Form C28-0323 
Tele-processing Supervisor, Form C28-0321 
Utility Programs, Form C28-0353 
Generalized Tape Sorting Program, Form C28-0354 
Autocoder, Form C28-0326 



COBOL, Form C28-0327 

FORTRAN, Form C28-0328 

File Organization System for IBM 1301/2302 Disk 
Storage, Form C28-0405 

Generalized Sorting Program Using IBM 1301/2302 
Disk Storage, Form C28-0404 

Support of IBM 1311 Disk Storage Drives, Form 
C28-0402 

Operating instructions for the Operating System, 
including instructions for System Generation, are con- 
tained in: 

Operators Guide, Form C28-0351. 

A knowledge of material contained in some of the 
above publications is required for System Generation. 
Specific reference to the pertinent information is made 
in this publication. 

Minimum Machine Requirements 

Two versions of the ibm Master file are provided: one 
for a tape-oriented installation, the other for a disk- 
oriented installation. Each is designed to enable the 
user to perform his initial System Generation (the 
creation of a System Generator file). The following 
machine requirements are the minimum configuration 
needed for System Generation. The Master file runs 
on the minimum machine configuration, as well as any 
configuration that exceeds the minimum. (Processing 
Overlap and Priority special features, which are stand- 
ard with the IBM 7010, are required. ) 

For the Tape-Oriented System 

40,000 positions of core storage 
5 magnetic tape units 
1 card reader ( or an additional tape unit ) 
Note 1: A printer or an additional tape unit for 
the Standard Print Unit is recommended in addition 
to the above machine requirements. 

Note 2: If 1311 Disk Storage is used for data files, 
60,000 positions of core storage are required. 

For the Disk-Oriented System 

60,000 positions of core storage 

1 module of ibm 1301 or 2302 Disk Storage 

2 magnetic tape units 

1 card reader ( or one of the above tape units ) 
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Note: It is recommended that a printer or addi- 
tional tape unit for the Standard Print Unit be sup- 
plied in addition to the above machine requirements. 



General Concepts 

As distributed to the user, the Master file contains all 
the components of the 1410/7010 Operating System. 
From the Master file, the user generates a System 
Generator file (sgf). From the sgf, the user creates 
one or more System Operating Files (sof) designed 
to perform specific data processing functions. 

Definitions 

Frequently used basic terms are defined below in rela- 
tion to their use in this publication. 

Monitor: The System Monitor without the Linkage 
Loader; that is, the combination of Bootstrap, Resi- 
dent Monitor (including the Resident iocs), and 
Transitional Monitor. 

Operating Section: All operating programs in ab- 
solute format (ready to execute). Monitor is part of 
the operating section. 

Library: An organized collection of subprograms 
or data to be used as input for System Generation. 
There are three types of libraries: 

1. Relocatable Library: Compiled subprograms in 
relocatable format. 

2. Macro Library: All the macro routines available 
to the Autocoder processor. 

3. Create Library: Prewritten packets of Linkage 
Loader control cards used to conveniently process 
standard programs into absolute format. 

Directory: A record, built during System Genera- 
tion, that contains the names and relative locations of 
the items of an associated file. 

Header: An identifying record at the beginning of 
every program phase or library. 

Largest Possible Records: An option offered for 
tape-oriented System Generation (specifically, the 
SG2 program). If this option is exercised, a phase of 
a program will be written in records of as many char- 
acters as possible. The last record of the phase may be 
short to contain any remaining characters. 

Macro Generation: An Autocoder function whereby 
symbolic statements are extracted from the Macro 
Library and become a portion of the subprogram 
being assembled. 

Disk: Refers to ibm 1301 or 2302 Disk Storage. 

Geometric Record Address: A disk record address 
whose four high-order digits are identical to the track 
number on which the record resides. 



Simultaneous Peripheral Operations On Line 
(SPOOL): This programming feature allows card-to- 
tape, tape-to-card, and tape-to-print operations to be 
performed concurrently with batched program (see 
System Monitor). 

Master File: An iBM-supplied source file consisting 
of: 

1. A minimum Monitor capable of operating on any 
acceptable machine configuration; 

2. A basic operating section capable of System Gen- 
eration; and, 

3. The Relocatable, Macro, and Create Libraries. 
System Generator File (SGF): A system file consist- 
ing of: 

1. A Monitor designed to operate efficiently in a par- 
ticular installation environment; 

2. An operating section capable of System Genera- 
tion; and, 

3. The library subprograms required for System 
Generation. 

System Operating File (SOF): A system file consist- 
ing of: 

1. A Monitor designed to operate efficiently in a 
particular installation environment; 

2. An operating section designed to efficiently proc- 
ess the user's programs and data; and, 

3. The library subprograms required for user proc- 
essing. 

The primary difference between the ibm Master file 
and an sgf is the Monitor. On the Master file, the 
Monitor is designed to operate in the minimum ma- 
chine environment. To gain full advantage of the 
Operating System, the user constructs his Monitor to 
utilize the facilities of his installation, and also selects 
any iocs or system function options (e.g., tape-label 
checking and unusual-end-of -program memory print) 
that would be useful to him. After an sgf is created, 
the Master file need not be used again, since the sgf 
effectively becomes the installation's "Master file." 

The distinction between an sgf and an sof is based 
entirely on operating efiiciency. The primary differ- 
ence between them is that the sgf must contain those 
elements required for System Generation, but an sof 
need not contain them. An sgf is designed for System 
Generation; an sof for production work. 



Tape- and Disk-Oriented Systems 

Orientation toward tape or disk is determined by the 
device (tape or disk) from which the Resident Moni- 
tor is loaded into core storage. Both systems are dis- 
tributed by IBM as single reels of tape — the Master 



file. The Master file for disk must be loaded onto disk 
storage before it can be used for System Generation. 
A tape-oriented Master file cannot be used for genera- 
tion of a disk-oriented system; similarly, a disk-oriented 
Master file cannot be used for generation of a tape- 
oriented system. 

Tape System 

The operating programs on the Master file for tape 
are designed for tape usage. The user can, after the 
initial System Generation, design his system to use 



disk storage files within the tape system (e.g., a disk 
file can be used for data files ) . 

Disk System 

The operating programs on the Master file for disk 
are designed for disk usage. Two tape units are man- 
datory for System Generation. The Disk Load program 
is supplied in order to copy the system onto disk. The 
user can, after initial System Generation, design his 
programs to use tape files within the disk system 
(e.g., a tape file can be used for data files). 
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Operating System Machine Requirements 



The Processing Overlap and Priority special features 
are required to use the 1410/7010 Operating System. 

System Generation 

The machine requirements for generation of the sgf 
from the Master file are described in the Introduction 
to this publication. 

Data Processing 
Unit-Record Requirements 

All configurations of the Operating System require: 

1 IBM 1402 Card Read Punch, Model 2, for use as 
the Standard Input Unit (siu) and/or the Stand- 
ard Punch Unit ( spu ) ; or 1 ibm 1442 Card Reader, 
Model 3, for the siu 

1 IBM 1403 Printer, Model 2, for use as the Standard 
Print Unit (spr) 

Note 1: Tape units may be substituted for each of 
the functions of card reading, card punching, and 
printing. 

Note 2: At the option of the user, punch and 
printer output may be intermixed on one tape unit for 
subsequent off-line punching and printing on an ibm 
1401 Data Processing System. If the variable print and 
punch modules are selected, the Core Image file 
( MDM ) and/or the Temporary Storage file ( mdt ) can 
also share this same tape unit. 

Note 3: At the option of the user, the standard 
print and/or standard punch capability may be elim- 
inated from the Resident Monitor. If no print unit 
is specified, (a) no diagnostic messages or memory 
map are provided by the Linkage Loader and ( b ) no 
compiler printed output is possible even though the 
compilers w^ill operate. If no punch unit is specified, 
the compilers will operate, but no program cards will 
be produced. 

Tape-Oriented Systems 

In addition to the unit-record requirements, tape- 
oriented systems require: 

1 tape unit for a System Operating File ( sof ) 

1 tape unit for a Job file ( mjb ) 

1 tape unit for a System Library file if this file is not 
on the same reel of tape as the sof 

Note 1 : If a Core Image file ( mdm ) is desired, an 
additional tape unit must be provided. This unit is not 
available for any other use unless the variable print 
and punch modules are selected. Selection of the vari- 
able print and punch modules allows the user to in- 
clude the mdm on the same tape unit containing the 
SPR and SPU. The mdm may be used for dumping 
error records. 

Note 2: The tape unit designated as the Job file 



is available as a work file if the program is loaded 
from the sof. 

Compiler Requirements: The three compilers (cobol, 
FORTRAN, and Autocoder) share work files. The user 
may include any or all three compilers in his system. 
In addition to the requirements listed for a tape- 
oriented system, the compilers require: 

3 tape units used as work files for the Autocoder 
and COBOL compilers, but 2 tape units for the 
FORTRAN compiler 
1 additional tape unit if the compile-and-go capa- 
bility is used 
Note: The tape designated as the Job file may be 
used as a work file during compilation. 

7307 Disk-Oriented Systems 

In addition to the unit-record requirements, 1301 disk- 
oriented systems require a series of contiguous cylin- 
ders formatted in the Load mode, one record per 
track, consisting of: 

1. Six cylinders for basic programs on the sof. 

2. Additional cylinders to accommodate: 
COBOL— 3 cylinders 

FORTRAN— 2 cylinders 

Autocoder— 7 cylinders 

Utilities and Sort Definition Program— 1 cylinder 

Job file— Each cylinder can store approximately 
60,000 positions of core storage; e.g., 6 cylin- 
ders are required for disk-oriented System 
Generation 

Working storage used by the compilers— No less 

,than 2 cylinders per file and a greater number 

according to the size of the program being 

compiled (should not exceed 10 cylinders per 

file) 

User-supplied programs— Each cylinder can store 
approximately 60,000 positions of core storage. 

3. Five additional cylinders if the compile-and-go 
capability is used. These five cylinders can accommo- 
date approximately 4,400 subprogram card-image rec- 
ords that are the output from the compilers. (To 
increase this capacity, additional cylinders may be 
provided. Each additional cylinder can store approxi- 
mately 880 card-image records.) 

4. Cylinders to accommodate the System Library 
file of relocatable programs as follows: 

The IBMLIBR requires 40 cylinders containing, in 
part, 1 cylinder for cobol subprograms and 4 
cylinders for Fortran subprograms. 

Additional cylinders for user-supplied subpro- 
grams (each cylinder can store approximately 
880 card-image records.) 



Note: I£ a Core Image file (mdm) is desired, and 
the variable print and punch modules have not been 
selected, a tape unit must be provided for the mdm. 
This unit is not available for other use. However, if 
the variable print and punch modules have been spec- 
ified, the MDM may share a tape unit w^ith any com- 
bination of the following system files: Standard Print 
Unit, Standard Punch Unit, and Temporary Storage 
file (mdt). 

2302 Disk-Oriented Systems 

The differences between 1301 and 2302 disk-oriented 
systems are a result of the increased track capacity of 
the 2302 disk file. In addition to the unit record re- 
quirements, 2302 disk-oriented systems require a series 
of contiguous cylinders formatted in Load mode, two 
records per track. Each of these records forms a dis- 
tinct symbolic file. While the 2302 requires the same 
number of cylinders as the 1301 for system residence, 
proper balancing of files in disk storage (e.g., assign- 
ment of the System Library file to the second record 
per track, etc.) can reduce by half the number of 
tracks required by the 2302 disk file. 

Generalized Tape Sorting Progrant Requirements 

In addition to the requirements listed for tape- and 
disk-oriented systems, the GeneraHzed Tape Sorting 
program requires a minimum of three tape units. For 
a tape-oriented system, these may be the same units 
used as work files by the compilers. Additional tape 
units may be used to increase the program's efficiency. 
(See the publication. Generalized Tape Sorting Pro- 
gram. ) 

Note: The tape unit designated as the Job file for 
the tape-oriented system may be used as one of the 
four tape units for the sorting program, if the sorting 
program is loaded from the sof. 

Generalized Sorting Program Requirements 

In addition to the requirements listed for a tape-ori- 
ented system, the Generalized Disk Sorting program 
requires 20,000 more positions of core storage and at 
least one module of ibm 1301/2302 Disk Storage. 

There are no additional machine requirements for 
using the generalized disk sorting program with a 
disk-oriented system. 

For both tape- and disk-oriented systems, optimum 
efficiency is; provided by: (1) use of two modules of 
IBM 1301 Disk Storage; or (2) use of one module of 
IBM 2302 Disk Storage in which each access arm serv- 
ices a different work area. 

Requirements tor File Organization System (FOS) 
An executable File Organization System requires the 
following minimum machine configuration: 
60,000 positions of core storage. 



One module of ibm 1301 or ibm 2302 Disk Storage. 

One magnetic tape unit (additional units are desir- 
able). 

An IBM 1402 Card Read-Punch and an ibm 1403 
Printer; or one or two magnetic tape units for the 
corresponding input/output functions. 

Tele-processing System Requirements 

Tape-Oriented Tele-processing Supervisor: 1 tape 
unit for storage of the tp Library file. 

1301 Disk-Oriented Tele-processing Supervisor: 1 
cylinder of disk storage, formatted in the Load mode, 
for storage of the Tele-processing Supervisor. 

If Tele-processing and batch processing occur con- 
currently, a tape-oriented system will require 60,000 
positions of core storage and a disk-oriented system 
will require 80,000 positions. Each system requires 
20,000 more positions of core storage than the mini- 
mum machine configuration needed for System Gen- 
eration. 

Additional cylinders of disk storage, formatted in 
the Load mode, for storage of tp programs. The effec- 
tive capacity of each cylinder is dependent upon the 
format used (i.e., relocatable or absolute) and the 
average size of the tp programs. 

To unload and reload the main-line program, the 
user must provide a tape unit or disk area for the 
Temporary Storage file (mdt). If the mdt is to be on 
tape, and the variable print and punch modules have 
been selected, the mdt may share the tape unit with 
any combination of the following system files: Stand- 
ard Print Unit, Standard Punch Unit, and Core Image 
file. 

Requirements for Systems Including the SPOOL Feature 

Use of the spool ( Simultaneous Peripheral Operations 
On Line) feature, which enables the user to perform 
such operations as card-to-tape and tape-to-card on 
line concurrently with regular processing, requires 
that the system contain a minimum of 60,000 positions 
of core storage. In addition, the Unit Record Priority 
Interrupt feature on the channel(s) used for spool 
must also be included. Other Operating System re- 
quirements are the same as those described above for 
the user's particular configuration. 

Requirements tor the Execution of Ob;ecf Programs 

The machine requirements for the execution of object 
programs produced by the three compilers (cobol, 
FORTRAN, and Autocoder ) vary according to the nature 
of the program, cobol and Fortran programs can refer 
to magnetic tape units and unit-record equipment. 
Autocoder programs can refer to disk storage and 
Tele-processing units as well as to magnetic tape units 
and unit-record equipment. 
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Basic Concepts — Tape-Oriented System 



This section applies only to a tape-oriented system 
and need not be read by persons interested only in a 
disk-oriented system. 



How the System is Built 

Functions to be Performed 

The Master file contains an operating section capable 
of building an sgf. The sgf incorporates those options 
desired by the user. To build the sgf, several programs 
from the operating section, which are in absolute for- 
mat, are executed. These programs perform the fol- 
lowing functions: 

1. Accept input data that describes the environment 
under which the new system is to operate, and incor- 
porate the optional items defined by each user. 

2. Preserve, for later use, any or all of the library 
elements supplied on the Master file. 

3. Build the absolute programs that the user speci- 
fies. 

4. Place these absolute programs on the output file. 
At the time this operation is being performed, the 
library material preserved in step 2 can be merged 
onto the output file. At the same time, directories are 
merged onto the output file. 



work tape produced by sgi. The relocatable input that 
it processes comes from: 

1. The output of the Autocoder run; and 

2. The Relocatable Library supplied on the Master 
file. The output, in absolute form, is placed onto the 
Job file, MjB. 

SG2: This program produces the directories re- 
quired and merges the programs, directories, and 
libraries into the new file. 



Defining the System 

Each user must define, through control cards, the 
Operating System that he desires. A detailed descrip- 
tion of the control cards is presented in "System 
Description Control Cards" and "System Generation 
Control Cards." Briefly, the user specifies the follow- 
ing: 

1. The number and types of input/output devices. 
A two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic units required. 

4. The variable and optional features desired within 
the Resident iocs. 



Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and selects the various options from 
those available in the form of Autocoder source state- 
ments. Autocoder processes this input by means of 
macro routines and generates the nucleus of the new 
Monitor. 

SGI: This program performs two main functions. 

1. SGI locates and copies the library material that 
the user desires to include in the new system. 

2. SGI prepares a tape that contains input control 
information for the Linkage Loader (linkload pro- 
gram. ) 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
SGF run. 

The user must give careful consideration to the 
various options available within the system. By choos- 
ing those options best suited to his needs, in addition 
to being aware of his installation's machine configura- 
tion, the user can prepare the control cards described 
in the section, "Organization of the Control Deck for 
the SGF." 



Construction of the File 

Each user must analyze his requirements for programs 
supplied to him on the Master file. The operating sec- 
tion of the Master file consists of the programs re- 
quired to do the initial run, Master to sgf. The operat- 



ic 



ing section is used in conjunction with the Relocatable, 
Macro, and Create Libraries to construct the sgf. 

A user may choose to utilize one of the Create Li- 
brary packets that will generate a "standard set" of 
programs on the sgf. These programs are those that 
a typical user might require. 

If a specified requirement must be met which is not 
covered by a Create Library packet, the user must 
provide the appropriate Linkage Loader control cards. 
The packet, or the use of individual create capabili- 
ties, determines the ultimate sequence of programs on 
the SGF. 

Organi^cation of the Control Deck for the SGF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including the date card. The Moni- 
tor places the date from this card in a Resident Moni- 
tor field called /dat/. 

2. JOB. 

3. ASGN cards assign symbolic unit entries to physi- 
cal input/output devices. 

4. MODE card describes the program operation 
wanted for the job. 

5. EXEQ AUTOCODER card causes the Monitor to locate 
and load the Autocoder processor. The card is fol- 
lowed by Autocoder source statements. These are 
macro statements that define the system. 

6. EXEQ SGI card causes the system to locate and 
load SGI. The cards which follow this exeq card are 
divided into two categories, sg control cards, Classes 
n. III, and iv, instruct sgi to locate and copy libraries. 
CJREAT control cards direct sgi to build a work file 
for the Linkage I^oader. 

Note: great control cards may be interspersed 
with (or replaced by) Linkage Loader control cards. 

7. EXEQ LiNKLOAD card causes the Linkage Loader 
to be located and loaded, The Linkage Loader is 
directed to obtain its control information from the 
file just created by sgi. Output is placed on the Job 
file. 

8. EXEQ SG3 card causes sgs to be located and 
loaded. The sg2 program has no control input. It can 
only be executed following one or more of the above 
programs that have prepared input data on prede- 
termined symbolic units. 

9. END. 

Additional information is given in the publication 
System Monitor. 

Example 1 

Figure 1 illustrates the control cards needed to build 
a typical sgf. 
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MON$$ DATE YRDAY 

MONSS JOB GENERATE TAPE ORIENTED SGF 

MONSS ASGN MWl ,B4 

MONSS ASGN MW2,A5 

MONSS ASGN MW3.B5 

MONSS ASGN MJBtAl 

MONSS ASGN MR0.A3 

MONSS ASGN MG0.B2 

MONSS MODE GOtSG 

MONSS EXEQ AUTOCODER . i . NOFLG . NOPCH 

HEADRGENERATE SGF 

GENOIPI ,R1 ,X1 

GEN02/MDM/,1,A0,A1,A2,A3,A4,A5,A6.A7,A8.A9 

GEN0 2/MDM/,2,B0tei,B2.E3.B4,B5tB6,B7,B8iB9 

GENOei700090119. , 55 . S , 09<9 , AO , R 1 . . . P 1 , X 1 , , . B6 . SN AP 

GEN0910 

GEN1010,A4,B4,A5.B5.A6 

GENl 1 

DEVDFl .729. 14 02. 1403 

0EV0F2.7330 

IOKDF1410.,A,4,5....,70000 

END 
MONSS EXEQ SGI 7 

LOCATC.CRcATLIB 

INSERC 

LOCATR, IBMLIBR 

INSERR 

LOCATM.AOTOCCDER 

INSERM 
END 

CREATTSYSTEM 
END 
MONSS EXEQ LINKLOAD 

INPUTMW2 
MONSS EXEQ SG2 L7 

MONSS END 

Figure 1. Control Cards Required for a Typical sgf for a 
Tape-Oriented System 



The sample deck begins with the initialization in- 
formation. This is followed by the job card, asgn 
cards assign symbolic units to specific input/output 
devices through their assignment symbols. 

The MODE card indicates that the output from any 
compiler is to be written on the Go file, mgo. This 
same card indicates that the operations that follow 
are to be executed in sg mode. This sets internal in- 
dicators that are tested by dependent programs and 
condition or alter their mode of operation. 

The EXEQ Autocoder card contains the fourth oper- 
and ( NOFLG ) and the fifth operand (nopch.) The 
NOFLG operand is a signal to Autocoder that the source 
statements that follow will knowingly violate the rules 
governing use of index registers, hence flags that 
would normally be a diagnostic warning should be 
suppressed. The nopch parameter suppresses the 
punch output from this compilation. 

The first source card to Autocoder is a headr card, 
which serves to identify the run. 

By comparing the sample cards with the detailed 
description of the input control cards given later in 
this publication, the input to Autocoder can be seen 
to indicate the following: 

Unit record equipment will be available on channel 1. The Core 
Image file will always be available on the new system. 

Magnetic tape units will be available on two channels, ten tape 
units per channel. 

The system will be a 1410 Data Processing System. 

Core-storage size will be 80,000 positions. 

The system will be tape oriented. 

The system files will contain no tape labels. 

There will be no Tele-processing devices. 

The Core Image file ( MDM ) will be available. 

The POW program will not be included. 
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The Standard Print Unit will be a 1403 Printer. 

The Standard Punch Unit will be a unit-record punch. 

An Alternate Input Unit ( AIU ) will be included. 

The number of lines per page will be 55. 

The size of the console inquiry message area will consist of five 

core-storage positions. 
JOB cards will not be punched. 
All Monitor control cards will be typed and printed. 
The new system tape normally will be mounted on a tape unit 

whose assignment symbol is AO. 
The SIU will refer to Rl. 
The SPR will refer to PI. 
The SPU will refer to XI. 
The Core Image file ( MDM ) will refer to B6. 
The Resident Monitor will include the Snapshot utility routine. 
Ten reserve units will be established. 
Ten work units will be established. 
The IOCS will provide routines for unit-record equipment and 

729 tape units on channel 1. 
The IOCS will provide routines for 7330 ( and 729 ) tape units 

on channel 2. 
The IOCS will have routines to check 120-character tape labels 

(no exits provided.) 
Error statistics are to be accumulated. 
User-written service routines will be provided for. 
The third record written on the Core Image file (MDM) will 

be written from location 70000. 
The last source statement to Autocoder is the END card. 

The EXEQ SGI card contains a 7 in column 59 to in- 
dicate the actual machine size. 

The control cards that follow the exeq sgi card re- 
quest SGI to copy the Create Library (creatlib), the 
Relocatable Library (ibmlibr), and the Macro Li- 
brary (which is a part of Autocoder.) These requests 
are terminated by the first end card. 

The second section of sgi control cards begins with 
the GREAT TSYSTEM Card. This card requests sgi to 
locate the Create package specified and to produce 
control information for the Linkage Loader (linkload). 
The control information will be in the form of Linkage 
Loader control cards (e.g., phase, call, calln). 

This section is also terminated with an end card. 

The EXEQ linkload card is followed by the input 
MW2 card. The input card directs linkload to obtain 
its control information from the tape file mw2 pre- 
pared by SGi. 

The EXEQ SG3 card contains additional control 
punches : 

COLUMN CONTENTS 

58 L Any character in this column indicates 

that the output should be constructed 
with "largest possible records." 

59 7 Character indicates the actual machine 

size. 

SG2 now merges the information processed above 
onto the new sgf. The sequence of the sgf is deter- 
mined by the sequence of information on the Job 
file, Mp. 

SG2 also processes requests contained on the Job file 
for directories and libraries. 

The final output, the sgf, appears on tape file mw2. 



Building an SOF 

This function is essentially a copy operation. Each 
item to be copied must be specifically requested. Any 
item(s) not specifically requested will not appear 
on the output file. 

Organization of the File 

In Example 1, the programs required for the sof run 
were converted into absolute format records. Hence, 
for this example, the most efficient way to produce the 
soF is to request that this file be constructed in the 
same sequence as the sgf. However, it is possible to re- 
sequence any or all of the operating section programs 
to produce a system that is most efficient from an 
operating viewpoint. In any case, the following pro- 
grams must appear first on the sof in the following 
order listed: 

IBBOOT 

ibresmon 

IBTRANSn 

Organization of the Control Deck for the SOF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including the date card. 

2. job. 

3. ASGN cards. 

4. EXEQ SGi. SGI control cards, Classes n, m, and iv, 
direct sgi to locate and copy libraries. SGi control 
cards, Class i, give the names of the specific items 
to be copied. Note that the sequence of these requests 
determines the sequence of the new file. 

5. EXEQ SG2. This card causes sg2 to build the final 
output tape. 

6. END. 

Example 2 

Figure 2 illustrates the control cards needed to build a 
typical soF. There is no card in the figure to declare 
mode SG; the sg mode is required only if the Linkage 
Loader is executed during system generation functions. 

The sample deck begins with standard initialization 
information, a job card, and asgn cards. 

The EXEQ SGi card used for this run does not require 
machine size indication in column 59; it is assumed 
that the sgf reflects the actual machine size. 

The EXEQ card is followed by requests to locate and 
copy the desired libraries. This section of control cards 
terminates with an end card. 

The next group of control cards contains specific 
requests to copy individual items from the input file. 
These requests determine the sequence of the final 
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MON»$ DATE VYOOO 

MONSS JOS COPY SOF WITH MULTIPLE TRANSITIONAL MONITORS 

MONSS ASGN MW1»B1 

MONSS ASGN MW2tB2 

MONSS ASGN MJBtAl 

MONSS ASGN MR0«A3 

MONSS EXEQ SGI 

LOCATRflBMLIKR 

INSERR 

LOCATCtCREATLIB 

INSERC 

LOCATMt AUTOCODER 

INSERM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

INCLDIBTRANSIT 

INCLDAUTOCOOER 

INCLDIBTRANSIT 

INCLDLINKLOAe 

INCLDIBMLIBR 

INCLDIBTRANSIT 

INCLDUTILITIES 

INCLDSGl 

INCLDCREATLI6 

INCL0SG2 

INCLDIBTRANSIT 

INCLDFORTRAN 

INCLDIBTRANSIT 

INCLOSORTDEFINE 

INCLDIBTRANSIT 

END 
MONSS EXEQ SG2 
MONSS END 

Figure 2. Control (^ards Required for a Typical sof for a 
Tape-Oriented System 

output file ( SOF ) . Contained in this group are specific 
requests to include (incld) the ibmlibr and the 
CREATLiB. These cards are required to establish the 
relative location of these items, sgi will prepare a re- 
quest ( for SG2 ) to show the location desired. Note that 
several copies of ibtransit have been requested. The 
group of control cards also terminates with an end 
card. 

The EXEQ SG2 card causes scs to build the final out- 
put tape. The functions performed by this program are 
the same as those outlined in Example 1. 



Addition of a User-Written Program 

An operation that is frequently carried out is the addi- 
tion of a user-written program to the operating section 
of an SOF. This function, like the previous illustrations, 
involves the building of a new system tape. 

Organization of SOF to be Updated 

To accomplish the updating of a system, the full capa- 
bilities of SGI can be employed. Therefore, the user 
may choose to resequence the operating section of the 
new SOF. The only restriction on sequencing is that 
iBBOOT, ][BRESMON, and IBTRANSIT must be the first 
items on the output file. 

Organization of the Control Deck 

Control cards follow the pattern established in Ex- 
ample 2 when adding additional programs to the sof. 
However, additional cards are required to: 
1. Establish mode sg; and 



2. Add the additional program, and resume the 
normal sgi functions. 

The sequence of the final output is determined from 
the sequence of the Job file. Because of this, the loca- 
tion of the additional cards is important. 

The first exeq sgi card begins requests that preserve 
the library elements that are to be retained. This sec- 
tion terminates with an end card. 

The INCLD cards direct sgi to build a Job file in the 
sequence specified. At the point where the new pro- 
gram(s) are to be inserted, SGi functions are termi- 
nated (temporarily) by an end card. 

The card exeq linkload, followed by the necessary 
control information and input deck(s), build the new 
program(s) onto the Job file. 

At the completion of linkload, the exeq sgi card 
appears again to cause the resumption of normal proc- 
essing. This causes the remaining programs to be 
placed on the Job file. 

Example 3 

Figure 3 illustrates the addition of a user-written pro- 
gram to the operating section of an sof. 

The sample deck begins with the date, job, and 
ASGN cards. 

The MODE SG card establishes the mode for the pro- 
grams that follow. This alters the normal operation of 
LINKLOAD so as to causc it to record information on a 
work file for sg3. 

exeq sgi is followed by requests to preserve library 
material. This section terminates with an end card. 

The next cards are sgi Class i requests to copy pro- 
grams from the operating section on the Job file. This 
section is also terminated with an end card. 

The EXEQ LINKLOAD card is followed by Linkage 
Loader control and input cards. In this example, the 
user's program has been previously compiled, and the 
relocatable deck from the compilation is placed im- 
mediately after the phase card. The user-written pro- 
gram resides on the lib or Go file as well as on the siu. 

The EXEQ SGi card is required only if it is necessary 
to resume the SGi function. In this example, sgi is re- 
quired because the new program to be inserted was 
not to be at the end of the Job file. 

Additional sgi Class i cards follow, specifying the 
programs to be copied onto the Job file. This section 
terminates with an end card. 

Note: At this point, the Job file is in the sequence 
desired for the output file. 

The EXEQ SG2 card causes scs to build the new tape 
in the same sequence as the Job file. At this time, 
library information and directories are merged onto 
the new tape wherever they have been requested. 
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MONiS 


DATE YYOOO 


MONSS 


JOB UPDATE DECK 


MONSS 


ASGN MJStAl 


MONSS 


ASGN MR0.A3 


MONSS 


ASGN MW1.B4 


MONSS 


ASGN MW2»A5 


MONSS 


MODE SO 


MONSS 


EXEQ SGI 




LOCATR.IBMLIBR 




INSERR 




LOCATM»AUTOCODER 




INSERM 




END 




INCLDIBBOOT 




INCLOIBRESMON 




INCLDIBTRANSIT 




INCLDAUTOCOOER 




INCLDLINKLOAO 




INCLDIBMLIBR 




END 


MONSS 


EXEQ LINKLOAD 




PHASEUSERPROG 


»»*»*»«#**»#»RELOCATABLE OECK»«**»*»#***»* 


MONSS 


EXEQ SGI 




INCLDSORTDEFINE 




INCLDIBTRANSIT 




END 


MONSS 


EXEQ SG2 


MONSS 


END 



Figure 3. Control Cards Required to Add a User-Written 
Program to the sof of a Tape-Oriented System 



General Maintenance Considerations 

Maintenance of the operating system covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the SGF, SOF, all Job files that have been saved, 
and all tp Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of aff^ected modules, 
copying (incld) any unaffected programs, and regen- 
eration of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating sections v^'hich 
were affected. As in item 2, any unaffected programs 
can be copied by use of the incld card. By careful 
planning, the user should be able to make changes to 
an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions concerning the 
operation of the Go file during maintenance of the Re- 
locatable Library. Refer to Class iv control cards inser 
and REPLC, under "System Generation Control Cards." 

Instead of the above method, the sg4 and sg5 pro- 
grams can be used to update the libraries as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm supplies a tape 
containing the changes to be made. This tape is used 
with the SG5 program to prepare an input tape for 



updating the libraries. If the user must make his own 
changes to ibm program modules, he can use the sg4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities eflS- 
ciently. 



Check List for System Generation (Tape- 
Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The absolute records size option (exeq sgs card) 
for systems that include Tele-processing devices 
should not specify largest possible records. 

3. The Sort Definition program should be generated 
by the initial generation if sort or merge programs are 
desired on an sof. 

4. Multiple copies of the Transitional Monitor 
should be placed on the sof to minimize the search 
time required for this element dviring operation. The 
Resident Monitor always makes a forward search for 
the Transitional Monitor. Multiple copies of any pro- 
gram can be placed on the sof to minimize search 
time. If multiple copies are included, they must be 
identical. For example, if one copy of Linkage Loader 
includes couple, all copies must include couple. Also, 
the user can create multiple copies of Transitional 
Monitor in the same run that Resident Monitor is gen- 
erated. This is done by inserting creattransit cards 
at the desired insertion points. 

5. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 
Relocatable Library can also be modified and the user 
can create as many relocatable libraries as desired, 
with the one restriction that only one of these can be 
named ibmlibr (or any other name.) ibmlibr is the 
name used by the Linkage Loader to find the System 
Library file if the user does not specify a different one. 
For relocatable libraries on separate reels, any name, 
including ibmlibr, can be assigned. 

6. COBOL and Autocoder use symbolic units mwi, 
MW2, and MW3 for work files during compilation; 
FORTRAN uses Mwi and MW3. Mwi and mw3 should 
be assigned to a different channel from mw2 for bal- 
anced and efficient usage. One additional tape unit is 
required if the compile-and-go capability is used. 

7. The Create Library must be named creatlib. 

8. If the COBOL "enter" verb is used in conjunction 
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with FORTRAN Subprograms, the relocatable modules 
required to run with cobol and Fortran object pro- 
grams must be in the same Relocatable Library. 

9. Every system must have the Bootstrap, the Resi- 
dent Monitor, and the Transitional Monitor (in that 
order) at the beginning of the tape. 

10. The maximum number of items that may ap- 
pear on an sof is 154. An item is defined as a program 
or a library. ( Examples : cobol is one item and ibmlibr 
is one item. ) 

11. Table 1 indicates the asgn cards that are re- 
quired during System Generation. 

12. The Generalized Tape Sorting program requires 



a minimum of four tape units (including the sof). 
These may be the same tape units as those used as 
work files by compilers. Additional tape units increase 
the program's efiiciency. See the publication Gener- 
alized Tape Sorting Program. 

13. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 

14. Programs that require the Autocoder "No-Clear" 
option for da statements must not be placed on the sof. 



Table 1. Tape System Input/Output Requirements 
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Basic Concepts — Disk-Oriented System 



This section applies only to a disk-oriented system and 
need not be read by persons interested only in a tape- 
oriented system. 



How the System is Built 



The output, in absolute form, is placed onto the 
Job file, Mp. 

SG2: This program locates and copies the library 
elements that the user desires in the new system. Its 
output is a new tape that is capable of being loaded 
onto the disk. This tape contains all items generated. 



Functions to be Performed 

The Master file contains a bootstrap disk load program 
that loads the Master file on the disk in preparation 
for System Generation. The absolute portion that is 
loaded on the disk is capable of building an sgf. The 
SGF incorporates those options desired by the user. To 
build the sgf, several programs from the operating 
section, which are in absolute format, are executed. 
These programs perform the following functions: 

1. Accept input data that describes the environment 
within which the new system is to operate, and in- 
corporate the optional items defined by each user. 

2. Build absolute programs that the user specifies. 

3. Place these absolute programs on the output file. 

4. Place the library elements on the output file. 

Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and the various options available in the 
form of Autocoder source statements. Autocoder proc- 
esses this input by means of macro routines and gen- 
erates the nucleus of the new system. 

SGI: This program performs one function. It pre- 
pares a tape which contains input control information 
for the Linkage Loader (linkload program). 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 
work tape produced by SGi and/or control cards from 
the siu. The relocatable input that it processes comes 
from: 

1. The output of the Autocoder run (item 1 above); 
and 

2. The Relocatable Library supplied on the Master 
file. (This library must have been loaded onto the 
disk. ) 



Defining the System 

The user must describe the Operating System that he 
desires through control cards. A detailed description 
of the control cards appears in "System Description 
Control Cards" and "System Generation Control 
Cards." 

Briefly, the user supplies the following: 

1. The number and types of input/output devices. A 
two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic unit entries 
required. 

4. The variable and optional features desired within 
the Resident iocs. 



Preparing to Buifd an SGF 

Before building an sgf or sof, it is necessary for the 
user to load the Master file or the source sgf onto disk 
storage. Instructions for performing this transfer to 
disk storage are given in "Disk Load Program." 

After the Master file is loaded onto the disk, it is 
necessary to format the disk areas required for the 
files (mp, mgo, MWi, MW3, and mws) used during 
System Generation. This is accomplished by using the 
1301 or 2302 Format/ Address Generator utility pro- 
grams. See the publication IBM 1410/7010 Operating 
System; Utility Programs, Form C28-0353, for instruc- 
tions in the use of these programs. 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
SGF run. 
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The user must give careful consideration to the 
various options available within the system. By choos- 
ing those options best suited to his needs, besides 
being avs^are of his installation's machine configuration, 
the user can prepare the control cards discussed in 
the section, "Organization of the Control Deck for 
the SGF." 

Construction of the File 

Each user must analyze his requirements for programs 
supplied to him on the Master file. The operating sec- 
tion of the Master file consists of the programs re- 
quired to do the initial run, Master to sgf. The oper- 
ating section is used in conjunction with the Relocat- 
able, Macro, and Create Libraries to construct the sgf. 

A user may choose to utilize one of the Create Li- 
brary packets that will generate a "standard set" of 
programs on the sgf. These programs are those that 
a typical user might require. 

If a specific requirement must be met which is not 
covered by a Create Library packet, the user must 
provide the appropriate Linkage Loader control cards. 

Organization of the Control Deck for the SGF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including booti card and the date 
card. The Monitor places the date from the date card 
in a Resident Monitor field called /dat/. Figure 4 
shows a 1410 bootstrap card for channel 2. 

2. JOB. 

3. ASGN cards assign symbolic unit entries to physi- 
cal input/output devices. 

4. MODE card describes the program operation 
wanted for the job. 

5. EXEQ AUTOCODER Card causes Monitor to locate 
and load Autocoder. The card is followed by Auto- 
coder source statements. These cards define the system. 

6. EXEQ SGI card causes the system to locate and 
load SGI. The cards that follow this exeq card must be 
Class ni SG control cards, great control cards direct 
SGI to create a work file for the Linkage Loader. 

Note,: sg control cards. Class in, may be inter- 
spersed with (or replaced by) Linkage Loader con- 
trol cards. 

7. EXEQ LiNKLOAD Card causcs the Linkage Loader 
to be located and loaded. The Linkage Loader is 
directed to obtain its control information from the file 
just created by sgi. 

8. EXEQ SG2 card causes sgs to be located and loaded. 
The cards that follow this exeq card are divided into 



two distinct groups. The first group consists of Class i 
sg control cards only. The Class i control cards direct 
SGS to locate the named eleraents and to copy them 
onto the new output file. 

The second group is made up of Class n, in, and iv 
control cards. (Class iv control cards must be last.) 
This group directs sgs to perform some operations on 
the libraries and to copy those libraries onto the new 
output file after the operations requested are complete. 

9. END. 

Additional information is given in the publication 
System Monitor. 

The newly created output file is a tape. To use this 
new system it is necessary to load this tape onto disk. 
See "Disk Load Program" for instructions. 

Example 1 

Figure 4 illustrates the control cards needed to build 
a typical sgf. 

The sample deck begins with the normal initializa- 
tion information. The first card contains the bootstrap 
that loads the first record of the system into core 
storage. This is followed by the job card, asgn cards 
assign symbolic units to specific input/output devices 
through their assignment symbols. 

The MODE card indicates that the output from any 
compiler is to be written on the Go file, mgo. This 
same card indicates that the operations that follow 
are to be executed in sg mode. This sets internal in- 
dicators which are tested by dependent programs and 
which condition or alter their mode of operation. 

The EXEQ autocoder card contains the fourth oper- 
and (noflg) and the fifth operand (nopch). The 
noflg operand is a signal to Autocoder that the source 
statements that follow will knowingly violate the rules 
governing use of index registers; hence flags that 
would normally be a diagnostic warning should be 
suppressed. The nopch parameter will suppress the 
punch output from this compilation. 

The first source card to Autocoder is a headr card, 
which serves to identify the run. 

By comparing the sample cards with the detailed 
descriptions of the control cards that appear later in 
this publication, the input to Autocoder will be seen 
to indicate the following: 

Unit record equipment will be available on channel 1. 
Magnetic tape units will be available on two channels, two tapes 

per channel. 
Nine disk files are defined on both channel 1 and channel 2. 
The system will be a 1410 Data Processing System. 
The core-storage size will be 80,000 positions. 
The system will be disk oriented. 
The system files will contain no tape labels. 
There will be no Tele-processing devices. 
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»•» INSERT 


BOOTSTRAP CARD ••» 






MONSS 


DATE YRDAY 






MONSS 


JOB GENERATE DISK SGF 






MONSS 


ASGN LIB.E2 






MONSS 


ASGN MJB.E3 






MONSS 


ASGN MG0.E4 






MONSS 


ASGN MWl ,E5 






MONSS 


ASGN MW2.E6 






MONSS 


ASGN MW3,E7 






MONSS 


MODE GO.SG 






MONSS 


EXEQ AUTOCOOERt t .NOFLG.NOPCH 
HEADRGENERATE DISK SGF 
GENOIPI .Rl ,X1 
GEN02. 1 .AO.Al 
GEN02«2.B0«B1 








GEN03E 1,0000 00 00, 21 99, E2. 00220000 


•2599, E3, 


.0026000 




E4. 0030 000 0. 3399. E5. 003400 00, 


.3799, E6, 


,0038000 




E7. 0042 00 0, 4599. E8. 004600 0, 


.4999. E9, 


,0050000 




GEN04G 1.0000 00 00, 21 99, G2, 00220000, 


.2599. G3, 


,0026000 




G4, 0030 0000, 3399, G5, 00 3400 0. 


.3799. G6, 


,0038000 




G7, 0042 0000, 4599, G8, 0046000 0, 


.4999, G9, 


,0050000 




GEN081 790000 110,. 55. 2 0.0 99. El .Rl . , 


..PI .XI 






GEN0910 








GEN1010.E4.G1.E6.E5.G2 








GENl 1 








DEVDFl .729.1402. 1403 








OEVOF2,7330 








DSKOFl.OO 








DSKDF2,00 








I0KDF1410.,. ,, . .8 








END 






MONSS 


ASGN MW2.A2 






MONSS 


EXEQ SGI 

CREATDSYSTEM 

END 






MONSS 


EXEQ LINKLOAD 
INPUTMW2 






MONSS 


EXEQ SG2 

LOCATM.MACROLIB 

INSERM 

LOCATC.CREATLIB 

INSERC 

LOCATR, IBMLI BR 

INSERR 

END 






MONSS 


END 







0.2999, 
0.4199. 
0.5399 
0,2999, 
0,4 199', 
0, 5399 



Figure 4. Control Cards Required for a Typical sgf for a Disk-Oriented System 



The Core Image file will not be available. 

The POW program will not be included. 

The Standard Print Unit will be a 1403 Printer. 

The Standard Punch Unit will be a unit-record punch. 

AIU capability will not be included. 

The number of lines per page will be 55. 

The console inquiry message area will consist of 20 positions of 

core storage. 
JOB cards will not be punched. 

AH Monitor control cards are to be typed and printed. 
The new system will normally be available in the disk area 

whose assignment symbol is El. 
The SIU will normally refer to Rl. 
The SPR will refer to PI. 
The SPU will refer to XI. 
Ten reserve units will be established. 
Ten work units will be established. 
The IOCS will provide routines for unit-record equipment and 

729 tape units on channel 1. 
The IOCS will provide routines for 7330 ( and 729 ) tape units 

on channel 2. 
The IOCS will provide for one module of disk on both channel 

1 and channel 2. 
Write disk checks will be performed. 
The last source statement to Autocoder is the END card. 

The EXEQ SGI card contains a 7 in column 59 to in- 
dicate the actual machine size. 

The SGI control cards begin with the great dsystem 
card. This card requests Create Library package 
DSYSTEM and produces control information for the 
Linkage Loader. The control information will be in 
the form of Linkage Loader control cards. 



The SGi control cards terminate with an end card. 

The EXEQ LINKLOAD card is followed by the input 
MW2 card. The input card directs linkload to obtain 
its control information from the tape file mws pre- 
pared by SGI. 

The EXEQ SG2 card contains an additional control 
punch: 



COLUMN 

59 



CONTENTS 

7 



Character indicates the actual machine 



SG2 now produces a new output tape on tape file 
MW3. The order of the disk file, except for the posi- 
tion of the relocatable library, is not important in a 
disk-oriented system because of the random access 
capability of disk storage. The newly created output 
file is on tape unit mw2. To use this new system, it 
is necessary to load this tape onto the disk. ( See "Disk 
Load Program" for instructions.) 



Building an SOF 

This operation is essentially a "copy" function. Each 
item to be copied must be specifically requested. Any 
item ( s ) not specifically requested will not appear on 
the output file. 
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Organization of the File 

In Example 1, the programs required for the sof run 
were converted into absolute format. 

A consideration for constructing a disk sof is to 
eliminate elements from the system so that less disk 
storage is required. Less disk area occupied by the 
system means that there will be more data area space 
available for production jobs. 

Organization of the Control Deck for the SOF 

The control deck for this operation is composed of the 
following sections: 

1. Initialization, including the date card. 

2. JOB. 

3. ASGN cards assign symbolic units to physical in- 
put/output devices. 

4. MODE card describes the program operation 
wanted for the job. 

5. EXEQ SGI card causes the system to locate and 
load SGI. The cards that follow this exeq card must be 
Class III SG control cards. These control cards instruct 
SGI to create a work file for the Linkage Loader. 

Note: sg control cards, Class iii, may be inter- 
spersed with (or replaced by) Linkage Loader control 
cards. 

6. EXEQ LiNKLOAD card causes the Linkage Loader 
to be located and loaded. This exeq card is followed 
by a control card which insti'ucts the Linkage Loader 
to obtain its control information from the file just 
created by sgi. In a disk-oriented system, only one 
exeq LINKLOAD Card may appear in the control card 
deck for each generation. 

7. exeq sg2 card causes sg2 to be located and 
loaded. The cards that follow this exeq card are di- 
vided into two distinct groups. The first group consists 
of Class I SG control cards only. The Class i control 



cards direct sg2 to locate the named elements and to 
copy them onto the new output file. The second group 
is made up of Class n, in, and iv sg control cards. (Class 
IV control cards must be last. ) This group directs sg2 
to perform some functions with the libraries and to 
copy those libraries onto the new output file after the 
function requested is complete. 

8. END. 

The newly created output file is a tape. In order 
to use this system it will be necessary to load this tape 
onto disk storage. (See "Disk Load Program" for in- 
structions. ) 

Example 2 

Figure 5 is an example that illustrates the control 
cards needed to build a typical sof. Inclusion of a 
user-written program in the sof is shown. 

The sample decks begin with standard initialization 
information. This is followed by the job card. The 
MODE card sets an internal indicator that is tested by 
the dependent programs that must alter their method 
of operation for System Generation mode. 

The group of asgn cards assigns the required files 
that are to be used for this job. 

The EXEQ card for this run does not require machine 
size indication in column 59; it is assumed that the sgf 
reflects the actual machine size. 

The control cards that follow the exeq sgi card 
request sgi to extract the control information from the 
Create Library packet named dfortran, and to pass 
this information to the Linkage Loader via tape file 

MW3. 

The exeq LINKLOAD is followed by the input mw2 
card. The input card directs the Linkage Loader to 
obtain its control information from tape file mws, as 
prepared by sgi. At the end of file on mws, the Link- 



6 16 21 

•»« INSERT BOOTSTRAP CARD •»• 

MON*l JOB^ CRfJtE disk SOF ORIENTED TO USER PROGRAM AND FORTRAN 

MON*$ MODE SG 

MONS« ASGN LIB*E2 

MONSS ASGN MJB.E3 

MONSS ASGN MW2.AI 

MON«S EXEQ SGI 

CREATDFORTRAN 

END 
MONS» EXEQ LINKLOAD 

INPUTMW2 

PHASEUSERNAME 
••»» RELOCATABLE DECK FOR USER PROGRAM ••• 
MON*» EXEQ SG2 

INCLOIBSGDL 

INCLOIBBOOT 

INCLOLINKLOAD 

END 
FORTRANLIBLOCATR. IBMLIBR 
IBSRTCOMANDELETR. IBCBLOVZER 
IBRANDOM OELETR.TPRDHBGEN 

END 
MONSS END 

Figure 5. Control Cards Required for a Typical sof for a Disk-Oriented System 
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age Loader returns to the siu and gets the control 
information to process the user-written program. 

The first group of cards presented to sg2 are Class i 
control cards. They indicate to sgs that the programs 
named are to be copied from the sgf to the new mas- 
ter tape file. After the three named programs are 
copied, SG2 will copy the Fortran and the user-written 
programs that were just placed on the Job file by the 
Linkage Loader. 

The next group of cards directs sg2 to locate ibmlibr, 
change its name to fortranlib, and to delete from 
this library the named routines and those that exist 
between the given names. The new fortranlib is 
then copied onto the new master tape. 

When the end card is read, the new file is produced 
by SG2 and a message is typed stating the unit on which 
the output file, mw2, is located. See "Disk Load Pro- 
gram" for a description of how to load this new file 
onto the disk. 



Shared Disk Files 

Four basic iocs generations are available (on a per 
channel basis) for a shared disk file environment. The 
basic generations may be used in many combinations 
in the sharing systems ( see "Permissible Combinations 
of Generations" in this section ) . 

Four IOCS Generations 

The four types of generations available, and their arbi- 
trary designations (Type A, Type B, etc.), are as 
follows: 

1. No Arm Sharing (Type A): Type A generation is 
suited to applications where the systems share the 
same ibm 7631 File Control unit, but do not compete 
for the same disk arm(s). A system using Type A gen- 
eration should not share the file control unit with a 
system using any other type of shared-file generation. 

2. Arm Sharing (Type B): Type B generation is 
suited to applications where the systems share the 
same ibm 7631 File Control unit and compete for the 
same disk arm(s). Under Type B generation, one sys- 
tem gains control of the file control unit and uses the 
shared disk file; the other system may perform other 
input/output operations and/or other processing until 
the first system has released control of the file control 
unit. 

3. Arm Stealing-Priority (Type C): Type C genera- 
tion is similar to Type B generation in that both sys- 
tems share the same ibm 7631 File Control unit and 
compete for the same disk arm(s). In Type C genera- 
tion, however, input/output requests to a shared disk 



temporarily controlled by the other system that shares 
the disk are issued repeatedly until the requests can 
be serviced; no other input/output operations or other 
processing can be performed. Type C generation is 
suitable for high-priority operations that must be serv- 
iced at the possible expense of other input/output op- 
erations or other processing. 

4. Arm Stealing^No Priority (Type D): Type D 
generation is a logical counterpart of Type C genera- 
tion. In Type D generation, control of the file control 
unit is relinquished whenever possible to enable serv- 
icing of higher priority requests (e.g., those initiated 
from a Type C generation). 

Permissible Combinations of Generations 

The permissible combinations of iocs generations for 
two IBM 1410/7010 Data Processing Systems sharing 
an IBM 7631 (Model V) File Control unit are indicated 
in the following list. 

Note: "System not using disk" means that a Prevent 
Seek Complete instruction (or its equivalent) has been 
executed and that either (1) the system has an iocs 
with disk capabilities, but does not issue disk com- 
mands, or (2) the system's iocs has no disk capabilities. 
IBM 1410/7010 IBM 1410/7010 

SYSTEM 1 SYSTEM 2 

Normal (not shared) disk IOCS System not using disk 

Type A System not using disk 

Type A Type A 

Type B System not using disk 

Type B Type B 

Type B Type C 

Type B Type D 

Type C System not using disk 

Type C Type C 

Type C Type D 

Type D System not using disk 

Type D Type D 

For an ibm 1410/7010 Data Processing System and 
some other ibm 7000 Series Data Processing System 
sharing an ibm 7631 (Model III) File Control unit, one 
combination of iocs generations is permitted: a Type 
A generation for the ibm 1410/7010 system and an 
equivalent generation for the other system sharing the 
file. If the latter system is not using the disk, the ibm 
1410/7010 can use any iocs generation (e.g.. Types B 
or C). 

Specifying Generation Desired 

Specification of the type of iocs generation desired in 
a shared disk environment is made in the dskdf macro- 
instruction described under "Disk Definitions for Resi- 
dent IOCS (dskdf)." In this specification, the channel 
number is prefixed with the type designation (A, B, 
etc. ) of the generation desired. 
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General Maintenance Considerations 

Maintenance of the Operating System covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the SGF, soF, all Job files that have been saved, 
and all t:p. Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of affected modules, 
copying (incld) any unaffected programs, and re- 
generation of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating section which 
were affected. As in above item, any unaffected pro- 
grams can be copied by use of the incld card. By care- 
ful planning, the user should be able to make changes 
to an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions of the operation 
of the Go file during maintenance of the Relocatable 
Library. Refer to Class iv control cards inser and 
REPLC, under "System Generation Control Cards." 

Instead of the above method, the sg4 and sg5 pro- 
grams can be used to update the libraries, as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm supplies a tape 
containing the changes to be made. This tape is used 
with the SGS program to prepare an input tape for up- 
dating the libraries. The program has an option that 
permits it to be used with a minimum disk system 
having only one tape unit available to the Operating 
System program. If the user must make his own 
changes to ibm program modules, he can use the sg4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities effi- 
ciently. 

Check List for System Generation 
(Disk-Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The Sort Definition program should be gener- 
ated by the initial generation if sort or merge programs 
are to be created on an sof. 

3. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 



Relocatable Library can also be modified. The library 
must be loaded onto the lib file when the system is 
loaded on the disk. 

4. COBOL and Autocoder use symbolic units mwi, 
MW2, and MW3 for work files during compilation; For- 
tran uses MWi and mw2. mwi and mw3 should be 
assigned to a different channel and/or module from 
MW2 for balanced and efficient usage of the 1301 disk. 

5. The Create Library must be named creatlib, and 
the Macro Library must be named macrolib. 

6. If the COBOL "enter" verb is used in conjunction 
with FORTRAN Subprograms, the relocatable subpro- 
grams required to run with cobol and Fortran object 
programs (refer to "Relocatable Library Contents") 
must be in the same relocatable library. 

7. The order of elements on the disk is of little im- 
portance because of the random access nature of the 
device. However, the placement of some of the ele- 
ments on the output tape, which contains the system, 
can be critical, and the following points should be 
observed: 

a. The first program on the tape must be ibsgdl. 
This is the Disk Load program. 

b. The second program must be ibboot. ibboot, 
for a disk-oriented system, comprises a boot- 
strap program (ibbootsd), the Resident Moni- 
tor, and the Transitional Monitor. 

c. The remaining programs may be in any order 
if they have been included from an existing 
SGF. If the system that is being built is to be 
capable of generating another system, ibsgdl 
must be included again. 

d. If an entire system is being generated, ibsgdl 
must be generated as the first program. Also, 
if the entire system being generated is to be 
capable of generating another system, then the 
ibsgdl program must also be generated last. 

8. Table 2 indicates the asgn cards that are required 
during System Generation. 

9. The Generalized Tape Sorting program requires 
a minimum of four tape units (including the sof). 
Additional tape units increase the program's efficiency. 
See the publication Generalized Tape Sorting Pro- 
gram. 

10. Each initialization of a disk system requires that 
the BOOTi card be first in the siu. The contents of this 
card are typed on the console printer during system 
loading. The operator key punches the card and places 
it in the siu. 

11. The Generahzed Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
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requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 



12. Programs that require the Autocoder "No-Clear" 
option for da statements should not be placed on the 

SOF. 



Table 2. Disk System Input/Output Requirements 



Physical Unit 
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2 


3 


4 


5 


6 


7 


8 


9 


Symbo 


ic Unit 


SOF 


SIU 


MWl 


MW2 


MW3 


MJB 


MOO 


LIB 


SPR 


c 
o 

.£| 


Autocoder 


1 


I 

3 

f 


J 

\ 

a 


I 

3 

1 

5 

f 


Work File 


Work File 


Work File 




Output 




,1 
1 

.0 

o 


SGI 




* Linkage 
Loader 
Input File 






Not 
Used 




SORT- 
DEFINE 




* Linkage 
Loader 
Input File 






Not 
Used 




LINKLOAD 




* Linkage 
Loader 
Input File 




Output 


From 
Autocoder 


Input 


SG2 




*New 
SOF 




Input 


Possible 
Input 


Input 


* Must 


be a tape unit. 
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System Generation Considerations 



Organization of Data Files on IBM 1301 or 2302 
Disk Storage 

Prior to System Generation, organization of disk stor- 
age must be determined; assignment symbols for the 
physical units into which each disk storage module is 
divided must be selected, and the disk must be for- 
matted. The Input/Output Control System for the 
IBM 1410/7010 Operating System provides for a num- 
ber of methods of organizing a disk file. 

Since almost all uses of the disk by system files re- 
quire Form G (Partitioned Sequential-Geometric) disk 
files, this form is discussed here. For example, the sof, 
compiler work files, the library, and the Go and Job 
files are Form G files. 

Form G (Partitioned Sequential-Geometric) makes 
it possible for more than one logical file to share the 
storage area available on one or more cylinders; the 
record sizes of the different files need not be the same. 
This can appreciably reduce seek time. 

Figure 6 depicts a use of Form G. The outside cyl- 
inder, cylinder 000, is assigned to work files mw7, 
MW8, and MW9 by the control cards shown below. 



6 

HON$» 
MON«» 
MON$$ 
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ASGN MW7tAltA2 
ASGN MW8|A3 
ASGN MW9,A4,A5 



Outside cylinder, 000 (Track 
addresses 0000-0039) 




250 cylinder positions 



40 disk surfaces 
available to read- 
write heads at each 
track position 



Assignments: 
AT - MW7 
A2 - MW7 Alt. 
A3 - MW8 
A5 - MW9 Alt. 
A4 - MW9 

Figure 6. 



The relation between the assignment symbols Al 

through A5 and the physical units must have been 

estabhshed during System Generation ( see the section, 

"System Description Control Card"). During System 

Generation: 

Al was specified as 00000000 to 00003900 
A2 was specified as 00000001 to 00003901 
A3 was specified as 00000002 to 00003902 
A4 was specified as 00000003 to 00003903 
A5 was specified as 00000004 to 00003904 

The Form G address format of these disk areas is: 



A MTTTT HR 



Last Two Digits of Record Address 
Track Number 

Record Address 



■ Module 

■ Access Mechanism 



Example of a Disk Module Organized for Form 
G Files 



For the example discussed here, access and module 
(am) are assumed to be 00. In the Form G address 
format, as for all geometric disk addresses, the first 
four digits of the record address correspond to the 
track number. The only difl^erence between these as- 
signments is the last two characters, the hr identifier. 

Each time the user issues a get or put in his source 
program, the iocs increments the tttt section of the 
address. When end of physical unit is reached, the file 
is switched to the alternate unit, if one is assigned. 
(In the example, A2 and A5 are the alternate units 
for MW7 and mw9, respectively. ) 

Before this form of record addressing can be used 
to execute an object program: 

1. The cylinder must be formatted to the desired 
scheme; and 

2. During System Generation, the System Monitor 
must be informed of the addresses by use of macro- 
instructions GEN03, GEN04, GEN05, and GEN06 — disCUSScd 

later in this manual. 

To use this form of record addressing in a source 
program, the user must write the proper dtf and da 
statements in his source program. 

Note: Data files can also be placed on ibm 1311 
Disk Storage. The organization of the 1311 disk is 
discussed in Support of IBM 1311 Disk Storage Drives 
Under the Operating System. 
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Relocatable Libraries 

Control cards needed to build and maintain relocat- 
able libraries for a tape-oriented system are discussed 
first; control cards needed to build and maintain re- 
locatable libraries for a disk-oriented system are then 
discussed. 

Building a New Library as Part of a Tape SOF 

During a System Generation run, the user may build 
additional relocatable libraries on the sof. 

For example, a new relocatable library can be 
added with the following cards subsequent to the 
EXEQ SGI card: 

16 21 

ADD I{,newname 
(Follow ADD card with the relocatable subpro- 
grams of the library, newname. These cards must 
appear prior to the first END card. ) 

In addition, the user must specify the insertion 
point of the new library. ( All relocatable libraries and 



the create packets of the Create Library require that 
the insertion point be specified. ) The insertion point 
is specified by a phase card during an sgf run. During 
a maintenance run, the insertion point is specified by 
an iNCLD card. 

Figure 7 shows the creation of an additional library 
on the SGF; Figure 8 shows the addition of a library to 
the SOF; and Figure 9 shows the maintenance, of an ad- 
ditional library on the sof. Control cards related to 
creation or maintenance of the additional library are 
indicated by ***. 

Note: In Figure 7, cbeattransit card(s) may be 
added to give additional copy(ies) of Transitional 
Monitor. 

Building a Library External to a Tape SOF 

Instructions for creating and maintaining external 
relocatable tape libraries that are not a part of the 
sof are given below. During this type of run, no other 
functions of System Generation may be used. 
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HONS» 


DATE YROAT 




















MONSS 


JOB ILLUSTRATE 


LIBRARY 


CREATION, 


GENERATE 


RUN 


MONSS 


ASGN MJB«A1 




















MONSt 


ASGN MR0,A3 




















MONS« 


ASGN MW2.A5 




















MONS« 


ASGN MG0.B2 




















MONSS 


ASGN MW1«B4 




















MONSS 


ASGN MM3.B5 




















MONSS 


MODE GOtSG 




















MONSS 


EXEQ AUTOCODER., 


,NOFLG.NOPCH 


















HEAORGENERATE SGF 




















GENOlPl.RUXl 






















GEN02/M0M/,1 ,A0, 


Al ,A2, A3 


,A4, 


AS, 


A6< 


,A7 


• AS, 


A9 


, 






GEN02/MDM/.2*B0. 


BI.B2,B3 


,B4, 


B5, 


B6< 


,B7, 


tB8, 


B9 


, 






GEN0ai700090119. 


,55,5, 099, AG 


,R1 


, , 1 


.PI 


.XI, 


, , 


B6, 


.SNAP 




GEN0910 






















GEN1010.A4.B4,A5 


,B5, A6 




















GENl 1 






















OEVOFl ,729, 1402, 


1403 




















DEVDF2,729 






















lOKDF 1410, ,,,,,« 


. . 70000 




















END 


, , * V V V v 




MONSS 


EXEQ SGI 

LOCATCCREATLIB 

INSERC 

LOCATR, IBMLIBR 

INSERR 
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• tt« 


ADD R, NEWNAME 




















»*» RELOCATABLE MODULES ••• 






















LOC ATM, AUTOCODER 






















INSERM 






















END 






















CREATTMONITOR 






















CREATRESTART 






















CREATSVSGEN3 






















CREATTAUTOCODE 






















CREATTLINKLOAO 






















PHASEIBMLIBR 


















R 


• «» 


PHASENEWNAME 

CREATTSYSGENl 

PHASECREATLIB 

CREATTSYSGEN2 

CREATUTILITIES 

CREATTMACROPRT 

CREATTFORTRAN 

CREATTCOBOL 

END 


















R 
C 


MONSS 


EXEQ LINKLOAD 
INPUTMW2 




















MONSS 


EXEQ SG2 














1 


L7 




MONSS 


END 





















Figure 7. Control Cards for the Addition of a User's Relocatable Library to the sgf of a Tape-Oriented System 
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6 

HON$$ 
HON|$ 

monH 

HONJJ 
MON$$ 
MONli 
MONIt 



••• RELOC 



16 



21 



MONS$ 
HCN$$ 



HON$» 
HON»i 



DATE YYYOQ 

JOB ILLUSTRATE ADDING LIBRARY DURING PROC 
ASGN MWl,e4 
ASGN MM2,A5 
ASGN MJB,AI 
ASGN MR0,A3 
MODE SG 

EXEO SGI 7 

LOCATCfCREATLlB 
INSERC 

LOCATR,IBMLIBR 
INSERR 

ADD RfNEWNAME 
ATABLE MODULES 

LOCATM, AUTOCODER 

INSERM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

JNCLORESTART 

INCLOIBTRANSIT 

!NCLDSG3 
NCLDAUTOCODER 
NCLDIBTRANSiT 
NCLDIBMLIBR 
END 

EXEQ LINKLOAD 
PHASENEWNAHE 
EXEQ SGI 

NCLDSGl 

NCLOCREATLIB 

NCLDSG2 

NCLDUTILITIES 

NCLDMACROPRT 

NCLDIBTRANSIT 

NCLDFORTRAN 

NCLDCOBOL 

NCLDIBTRANSIT 
END 

EXEQ SG2 
END 



Figure 8. Control Cards for Addition of a User's Relocatable Library to an sof of a Tape-Oriented System 



6 

MONii 
HONfi 
MONii 
MONIi 
HON»i 



BUILDING AN INDEP 
ENDENT TAPE LIB 



Building an Independent Tape Library 

Control cards used to build an independent library are 
shown below. (Assignment symbols used in this ex- 
ample are those appearing under "IBM Master File — 
Tape-Oriented System.") 

16 21 

JOB BUILD LIBRARY 

ASGN MW1.B4 

ASGN MW2,AS 

ASGN HR0.A9 

ASGN Mje.Al 

EXEQ SGI 

IRELOCATABLe'sUBPROGRAMS to BE INCLUDED IN 

RELOCATABLE LIBRARY) 
END 
MON$t EXEQ SG2 S»» 

MON$i END 

*LIBNAME can be any name not exceeding ten characters. 
** Column 57 contains any character. 

Execution of sgi and sg2 produces a library file on 
symbolic unit mwi and a list of library subprogram 
names on the spr. (Date of compilation of each sub- 
program is also shown. ) 

This library file can be used by: 

1. Assigning symbolic unit lib to an assignment 
symbol other than the one assigned to the sof; and 

2. Referencing the library name as the fourth pa- 
rameter of the execute card for linkload. 

Every reference to a library in the operation of 
Linkage Loader accesses the library file. The library 
name must be the same as the name specified in the 
EXEQ LINKLOAD card (fourtli parameter). 

Maintaining a Tape Library 

Control cards used to update a library are shown in 
the following example. 



6 

MON$$ 
MON$i 
MON$$ 
MON»> 
MON»( 
HON$i 
MONSi 



•HODULEC REPLCR 



JOB MAINTAIN LIBRARY 

ASGN MHlfBA 

ASGN MR0fA3 

ASGN MJBtAl 

ASGN MW2fA5 

ASGN LIBfBO 

EXEQ SGI 

ALTLBTAPE 



(New relocatable subprogram, MODULEC, that 
replaces old MODULEC) 



•MODULEN 
MODULEX 



OELETR 
INSERR 



(Relocatable subprogram, MODULEX) 



MONii 
MONii 



END 

EXEQ SG2 
END 



• •X 



* Subprograms must be referenced in the sequence in which 
they appear on the tape library. 
** Column 57 contains any character. 

The execution of sgi provides an updated library 
( LIB ) on Mwi, and the execution of sg2 provides a list 
of library subprogram names on the spr. modulec is 
replaced with a new modulec; modulen is deleted; 
and MODULEX is inserted at the end of the library. 
Refer to "System Generation Control Cards" for the 
method of inserting a subprogram between existing 
subprograms of the library. 

Additional information will be found under "System 
Maintenance." 

Disk Relocatable Library Considerations 

All relocatable libraries are "external" libraries in the 
disk system. During the loading of a disk system 
(tape-to-disk), the relocatable library on the input 
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HON$S 
MONSS 
MONS$ 
MON$$ 
MONSS 
MONSS 
MONSS 



»♦♦ INSER» 



MONSS 
HONSS 



DATE YYDOD 

JOB ILLUSTRATE LIBRARY MAINTENANCE. INCLO RUN 
ASGN MWltB^ 
ASGN MW2»A5 
ASGN MJBfAl 
ASGN MR0>A3 

EXEQ SGI 7 

L0CATC»CREATL1B 
INSERC 

LOCATR.IBMLIBR 
INSERR 

LOCATRtNEWNAME 
REPLC. AND DELET CARDS FOLLOWED BY RELOCATABLE MODULES *«• 
LOCATM. AUTOCODER 
INSERM 
ENB 

INCLDIBBOOT 
INCLDIBRESMON 
INCLDRESTART 
INCLDIBTRANSIT 
INCLDSG3 
INCLOAUTOCOBER 
INCLDIBTRANSIT 
INCLDLINKLOAO 
INCLDIBTRANSIT 
INCLDIBMLIBR 
INCLDNEWNAME 
INCLOSGl 
INCLOCREATLIB 
INCLDSG2 
INCLDUTILITIES 
INCLDMACRO^RT 
INCLDIBTRANSIT 
INCLOFORTRAN 
INCLOCOBOL 
INCLDIBTRANSIT 
END 

EXEQ SG2 7 

END 



Figure 9. Control Cards for Maintenance of a User's Relocatable Library of the sof of a Tape-Oriented System 



tape must be loaded into the disk area to be assigned 
as LIB ( instead of the sof ) . 

During a standard 'System Generation run, the one 
library (lib) can be copied onto the tape that con- 
tains the new system. If complete regeneration capa- 
bilities are to be preserved, this library must contain 
all library subprograms supplied on the Master file. 

Instructions for creating and maintaining a disk 
library are given below. 

Building a Disk Library 

Control cards used to build a new disk library are 
shown below. (Assignment symbols used in this exam- 
ple are those appearing under "IBM Master File — 
Disk-Oriented System.") 



6 

MON$i 
HONtS 
HONSS 



16 21 

JOB euiLO LIBRARY 

ASGN MW2,Al» 

EXEQ SG2 

ADD R.HBNAME«»» 

( Relocatable subprograms 
Relocatable Library) 

END 
END 



• •X 



to be included in 



HONSS 

*A1 must be a tape unit. 
**Column 57 contains any character. 
***LIBNAME can be any name not exceeding ten characters. 

The new library is produced on tape unit mw2. To 
use this new library, it must be loaded onto the disk 
in the area assigned as lib. The program dsklibldr is 



used to perform this function, as described under 
"Disk Load Programs." 

Maintaining a Disli Library 

The four general situations for which a disk relocat- 
able library can be maintained are: 

1. The library on disk (lib) to be updated and 
written onto tape unit mw2; mws to contain only the 
library material. 

2. The library-only tape ( created by a previous run ) 
to be updated and written onto tape unit mws; mw2 
to contain only the library material. 

3. The library on disk ( lib ) to be updated and writ- 
ten onto tape unit mw2 following the disk system sof 
or SGF. 

4. The library-only tape ( created by a previous run ) 
to be updated and written onto tape unit mws follow- 
ing the disk system soF or sfg. 

All maintenance of relocatable libraries produces 
tape output. This tape must be loaded onto the disk 
in the area assigned to lib to make the library avail- 
able to dependent programs. (Refer to "Disk Load 
Programs.") 

Figures lOA and lOB, respectively, illustrate the con- 
trol cards required to provide maintenance for the first 
two situations listed above. 

The third situation is illustrated in Figure 5. 
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For the fourth situation Hsted above, two changes 
must be made in the control cards shown in Figure 5: 
the LOCAT card is replaced with an altlb tape card; 
and an asgn card is added, immediately preceding the 
EXEQ SGS card, to assign lib to a tape unit. 

Note: For further information, see "System Main- 
tenance." 



6 16 21 

MONSS JOB NO.l. UPDATE LIB ONLY, DISK TO TAPE 

MONSS ASGN LIB«E4 

MONSS ASGN MW2,A1 TO A TAPE UNIT 

(NOTE PUNCH IN COL. 57 OF NEXT CARD) 
MONSS EXEQ SG2 X 

LOCATR.LIBNAME 
•••INSER» REPLC. OELET CARDS AND RELOCATABLE MODULES**" 

END 
MONSS END 



Figure lOA. Control Cards to Update a Disk Library onto a 
Library-Only Tape 



MON$$ JOB N0« 2, UPDATE LIB ONLY, TAPE TO TAPE 
MON$$ ASGN LIB.BJ TO A TAPE UNIT 

MON$$ ASGN MW2.A1 

(NOTE PUNCH IN COL. 57 OF NEXT CARD) 
MON*$ EXEQ S62 X 

ALTLBTAPE 
»»»INSER, REPLC* DELET CARDS AND RELOCATABLE MODULES*** 

END 
MONSS END 

Figure lOB. Control Cards to Update a Library-Only Tape 
onto a New Library-Only Tape 



Sort Definition Program 

The Sort Definition program (sortdefine for tape, or 
DSRTDEFiNE for disk) must be an absolute program on 
the SOF or sgf if sort programs are to be incorporated 
onto an sof. The Sort Definition program is incorpo- 
rated onto an sgf automatically when the great cards 
TSYSTEM or DSYSTEM are used to create the sgf. An al- 
ternative to this is the use of the great card tsrtdefin 
(for tape), or the great card dsrtdefin (for disk). De- 
tails appear under "Contents of the Libraries," and 
"Creation Charts." 

The absolute Sort Definition program is copied from 
an SGF to an sof by inserting the card incld sortdefine 
(or DSRTDEFINE ) iuto the deck, which is illustrated in 
the section "Building an SOF" under "Basic Concepts." 
The INCLD card copies the Sort Definition program 
during the maintenance of an sof. 

Sort programs are incorporated onto an sof using an 
operation similar to that discussed under "General 
Maintenance Considerations" of "Basic Concepts- 
Tape-Oriented System," or "Basic Concepts-Disk- 
Oriented System." The control cards for execution of 
the Sort Definition program are explained in the pub- 
lications Generalized Tape Sorting Program and Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. Any set of sort definition control cards de- 



scribed in the above publications is acceptable, in- 
cluding those required for a modified sort program. 
Figure 11 illustrates the incorporation of a single 
tape sort program onto an sof. To incorporate a single 
disk sort program, the user must change references to 
SORTDEFINE to refer to dsrtdefine. 



MONSS DATE YYDDD 

MONSS JOB ILLUSTRATE SORTDEFINE 

MONSS ASGN MJB,A1 

MONSS ASGN MR0,A3 

MONSS ASGN MW2,A5 

MONSS ASGN MW1,B4 

MONSS ASGN MW3,B5 

MONSS MODE SG 

MONSS EXEQ SGI 

LOCATC.CREATLIB 

INSERC 

LOCATR.IBMLIBR 

INSERR 

LOCATM ♦AUTOCODER 

INSERM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

INCLDIBTRANSIT 

INCLDAUTOCODER 

INCLDSORTOEFINE 

INCLDLINHLOAD 

INCLDIBMLIBR 

END 
MONSS EXEQ SORTDEFINE 
SORTEXMPLEDSORTSORT .FIXED. MULT I PLE.UNMODIF 

DUNITMW1.MW2.MW3 
MONSS EXEQ LlNHLOAD 

INPUTMW2 
MONSS EXEQ SGI 

INCLDS61 

INCLDCREATLIB 

INCLDSG2 

END 
MONSS EXEQ SG2 
MONSS END 

Figure 11. Control Cards to Incorporate a Single Sort Program 
onto an sof 



The File Organization System 

The File Organization System (fos) is a set of ibm 
1410/7010 Operating System programs designed to 
store and maintain data files in ibm 1301 or 2302 Disk 
Storage, fos permits object programs to address rec- 
ords in disk storage through record identifiers, without 
using disk addresses, or to retrieve data files in record 
sequence without the use of outside lists or "finder 
files." 

The File Organization System is created by the Sys- 
tem Definition program of the Master file. In both the 
tape-oriented and disk-oriented Master files, the Sys- 
tem Definition program and File Organization System 
control and operating modules (e.g., ibfosadd) are 
included in relocatable form in the Relocatable Li- 
brary. The System Definition program is also included 
in absolute form in the operating sections of the Mas- 
ter files. System Generation options provide a variety 
of ways in which the appropriate sof may be built 
from the Master file, and used. 
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Requirements for System Description Control Cards 

The File Organization System requires that specific 
parameters be included in the control cards defining 
the type of operating system desired by the user (see 
"System Description Control Cards" ) . For purposes of 
this discussion, it is assumed that the appropriate Disk 
Definition (dskdf) control cards are part of the sg 
deck. The File Organization System imposes no re- 
quirements on the DSKDF macro statement except that 
it must be present. Specific fos requirements for the 
System Description control cards are: 

1. Parameter 4 of the genos macro statement must 
be 20 because fos requires a 20-position console Input 
Area in Resident Monitor. 

2. Parameter 18 of the genos control card must be 
the address of the first track of the disk storage area 
reserved as File Directory and Index area for fos use 
( see "Monitor Definitions genos" ) . 

3. Parameter 7 of the iokdf macro statement must 
be present if any organized file contains Form 1 rec- 
ords. 

4. Parameter 8 must be present if any fos program 
is to use the Write Disk Check option. 

Relocation and Execution of the System 
Definition Program 

The major methods of relocating and/or executing the 
System Definition program are outlined below: 

If the Master file is used, or if the source sgf con- 
tains the System Definition program in absolute form, 
the definition program can be executed during System 
Generation to produce user-defined fos programs. Re- 
quired control cards for the execution of the System 
Definition program are: 

MON$$ EXEQ DEFINE 

I userlabel SYSDF parameters* 

These control cards, and the subsequent action of the 
Linkage Loader and sg3 programs, cause the defined 

I fos program, userlabel, to appear on the sof in abso- 
lute form. 

The iBLOOKM module is required in the Relocatable 
Library for the creation of the File Organization Sys- 
tem. 

I If it is desired to copy the absolute-form System 
Definition program from one sof to another, or from an 
sgf to an sof, the control card incld define should be 
used. (The inc3LD card, if present, must follow the 
EXEQ sGi card for a tape-oriented system, or the exeq 
sg2 card for a disk-oriented system. ) 

* For a description of these parameters see the publi- 
cation, "File Organization System for IBM 1301/2302 
Disk Storage." 



If an sof being produced is to contain the System 
Definition program, in absolute form, and the source 
file ( Master file or sgf ) contains the program in relo- 
catable form only, the sgi control card should be fol- 
lowed by a great define card, or the Linkage Loader 
control cards: 

PHASE DEFINE 

CALL IBFOSYSDEF 
Subsequent execution of the Linkage Loader and sgs 
programs brings in the System Definition program 
from the Relocatable Library, relocates the program, 
and places it on the sof in absolute form. 

The FOS control and operating modules in the Relo- 
catable Library include two forms of the Add func- 
tion module: ibfosadd and ibfosadds. ibfosadd is used 
with IBM 1301 Disk Storage only; ibfosadds must be 
used with ibm 2302 Disk Storage and may also be used 
with 1301 Disk. During System Generation, either of 
these modules may be deleted from the sof by replac- 
ing the iNSER R card, which ordinarily follows the 
LOCAT r,ibmlibr Card, with the following card: 

IBFOSADDn DELET R 
where n is blank to delete ibfosadd or 2 to delete 
IBFOSADD3. The Relocatable Library ( except the named 
module) will be copied. 

Building Monitors with Tele-processing 
Capabilities 

The Tele-processing Supervisor becomes a part of the 
Resident Monitor through System Generation. To per- 
mit inclusion of the Supervisor at the proper point in 
the Resident Monitor, special Create Library packets 
can be used. These packets aid in building a tape- or 
disk-oriented Monitor for either a standard configura- 
tion or a TP Only configuration. 

Ba'sically, there is a create packet that precedes the 
Supervisor call cards, and another create packet that 
follows them. The pairs of packets are: 

TMONTPl These packets create a standard tape Monitor 

TMONTP2 with Tele-processing capabihties. 

DMONTPl These packets create a standard disk Monitor 

DMONTP2 with Tele-processing capabilities. 

The rules governing the calling of the various mod- 
ules to make up a tp complex, as well as the names 
and functions of each module, appear in the publica- 
tion, Tele-processing Supervisor. 

Figure 12 is an example for building a standard tape 
Monitor for a Tele-processing system using the ibm 
1014. 

Figure 13 is an example for building a standard 
disk Monitor for a Tele-processing system with Pro- 
grammed Transmission Control (ptc). 
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6 

MON($ 
MON$» 
MON$$ 
MGN$» 
MON$$ 
MON$$ 
MON$t 
HON»$ 
MON$$ 
MQN$$ 



HON$$ 



MONSS 



MON$$ 
MON$$ 



12 21 

DATE YROAY 

JOB GENERATE TP TAPE SYSTEM 

ASGN MR0,A3 

ASGN MJB,B3 

ASGN HG0fB2 

ASGN MM1|A4 

ASGN MW2fA5 

ASGN MW3.B4 

MODE GO.SG 

EXEQ AUTOCODER, ..NOFLG.NOPCH 

HEADRGENERATE TP TAPE SYSTEM 

GENOlPl.Rl.Xl 

GEN02 /MOM/ , 1 , AO , Al » A2 , A3 , AA , A5 , A6 , A7 

GEN02/MDM/,2,B0,B1](B2,B3,B4.B5,B6,B7 

GEN081700990110,4000,55,20,699,AO,R1,,,PI,X1, ,,B6,SNAP 

GEN0910 

GEN1010,A4,B4>A5,B!>«A6 

GEN115 

DEVDFl,729,1402,1403,,TP 

DEVDF2,729 

IOKOFl4lO.,,,,,, ,,70000 

TPDIR30,10 

END 

EXEQ SGI 

L0CATR,16MLIBR 

INSERR 

LOCATM, AUTOCODER 

INSERM 

END 

CREATTMONTPl 

CALLNTPSTARTCHl 

CALLNTP1014CH10 

CAULNTPENDCHl 

CALLNTPTAPELDRA 

CALLNTPSUPER 



CREATTM0NTP2 

PHASETPATLIBGEN 

CALL TPATLIBGEN 

CREATTLINKLOAD 

CREATTAUTOCODE 

CREATTSYSGENl 

CREATTSYSGEN2 

PHASEIBMLIBR 

END 

EXEQ LINKLOAD 

INPUTMW2 

EXEQ SG2 

END 



USER INSERTS THE EXECUTIVE HERE 



Figure 12. Control Cards for a Tape-Oriented Monitor for a Tele-processing System with ibm 1014 



Each example indicates where the user is to insert 
his Tele-processing Executive. This can be done in one 
of three ways : 

1. The user can insert the relocatable object deck 
at the place indicated in the examples. 

2. The user may have included the Executive in the 
relocatable library and can call it with a calln card. 

3. The user may insert his Autocoder source deck 
after the tpdir macro and have the object deck placed 
on the Go file. This module can then be called with a 
CALLN card at the appropriate time. 

Random-Processing Scheduler 

One of the relocatable subprograms ( ibrandomi ) re- 
quired by the Random-Processing Scheduler mijst be 
compiled by each user. The following steps indicate 
the method of generating the subprogram and incor- 
porating it into IBMLIBRt 

1. The user includes the (3enrm macro ( see "System 
Description Control Cards") in his deck when gener- 
ating the SGF. This produces ibrandomi, the relocat- 
able subprogram, written on the Go file. 

2. The user then requests that ibrandomi be in- 
corporated into the Relocatable Library by plac- 
ing the following card into the deck following the 
locatRjIBMlbbr card: 

6 16 21 

IBRANDOMI INSER R,IBRANDOM2 



If no Other maintenance is to be performed on the 
library, this is the only card required. Refer to Class 
IV control cards (under "System Generation Control 
Cards") if other maintenance is to be done. 

Macro Print and Punch Program 

The Macro Print and Punch program can write infor- 
mation selected from the Macro Library onto the 
Standard Print Unit and onto either the Standard 
Punch Unit or any mrx or mwx symbolic unit previ- 
ously assigned to a tape unit. The output on the spr 
is printed output, and the output on the spu or tape 
unit is punched output of macroprt. The printed out- 
put can consist of any or all of the following items: 

1. The identifier (get, genoi, etc.) of each macro 
routine. 

2. The contents of a macro routine. 

3. The page and line number of every reference to 
L characters in model statements. L characters are 
the one-character labels appearing in column 6 of the 
Library Coding Form. This information is referred 
to as "cross-reference" information. 

The punched output consists of 80-character rec- 
ords in standard Macro Library format (see the pub- 
lication Autocoder, Form C28-0326). The following 
SYSGEN control card will appear on the punched out- 
put file before the first statement of each macro 
punched: 
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6 
INSERT 
HON»$ 
MON$$ 
MON$$ 
MON$$ 
MON$$ 
MON$$ 
MON$i 
MON$$ 
MaN$$ 
MON$« 



MON$$ 
MON$$ 



16 21 
BOOTSTRAP CARD ••• 

DATE YRDAY 

JOB GENERATE 01 

ASGN LIB,E2 

A.SGN MJB,E3 

ASGN MG0,E4 

ASGN MW1,E5 

ASGN MW2,E6 

ASGN MW3iE7 

MODE GO.SG 

EXEQ AUTOCODER, f 

HEADRGGNERATE 01 

GEN01P1,R1,X1 

GEN02,1,A0,A1 

GEN02,2,B0,B1 

GEN03E1, 00000006 
E4, 00300000 
E7, 00420000 

GENO'fGl, 00000000 
64,00300000 
G7, 00420000 

GEN081790990110, 

GEN0910 

GEN1010,E4,G1,E6 

GEN115 

OEVDFl, 729, 1402, 

0EV0F2,729 

DSKDF1,00 

DSKDF2,00 

I0KUF1410.,,,,,, 

TPDIR30,10 

END 

ASGN MW2,A2 

EXEQ SGI 

CREATDMONTPl 

CALLNTPPTCCHl 

CALLNTPSUPER 

CALLNTPDISKLORA 



HON$$ 
MQN$$ 



HON$$ 



SK SYSTEM WITH TP 



,NOFLG,NOPCH 
SK SOF WITH TP 



, 2199, E2, 00220000 
,3399, £5,00340000 
, 4599, E8, 00460000 
, 2199, G2, 00220000 
,3399,05,00340000 
, 4599, G8, 00460000 
4000, 55, 20, 099, El 

,E5,62 

1403,,, PTC 



, 2599, E3, 00260000, 2999, 

,3799, £6,00380000, 4 199, 

,4999, £9,00500000, 5399 

,2599,03,00260000,2999, 

,3799,66,00380000,4199, 

,4999,09,00500000,5399 

,R1,,,P1,X1,,,,SNAP 



GREAT 

PHASE 

CALL 

GREAT 

GREAT 

GREAT 

GREAT 

END 

EXEQ 

INPUT 

EXEQ 

LOCAT 

INSER 

END 

END 



0M0NTP2 

TPADLIBGEN 

TPADLIBGEN 

DLINKLOAD 

DAUTOCODE 

DSYSGENl 

DSYSGEN2 

LINKLOAD 

MW2 

SG2 

R,IBMLIBR 

R 



USER INSERTS THE EXECUTIVE HERE 



Figure 13. Control Cards for a Disk-Oriented Monitor with Programmed Transmission Control tp Capability 



6 16 21 

NAMEl REPLCM 

where namei is the macro name. In addition, every 
macro statement will have the id field punched in 
positions 75 through 80 as follows: 

75 80 
bNAMEl 

where namei is the macro name. The last record of 
the punched output file is the following sysgen con- 
trol card: 

16 
END 

The Create Library packets needed to build this 
program for a tape- or disk-oriented system appear 
under "Creation Charts." 

System Requirements 

MACROPRT is not run during System Generation; it 
requires a standard job run. The running of the pro- 
gram requires that macroprt must have been placed 
on the SOF during System Generation. 

EXEQ Card 

The EXEQ card is a standard Monitor control card and 
is used to call in the macroprt program. It also serves 
to select the printing or punching options (or both). 



The printing of macros is always assumed; the follow- 
ing EXEQ card will cause printing only: 

6 16 21 

MON$$ EXEQ MACROPRT 

The following exeq card will cause printing and 
punching: 

6 16 21 

MON$$ EXEQ MACROPRT , , , xyz 

where xyz is spu, mrx, or mwx and indicates where to 
put the macro statements. 

To inhibit printing while punching, the following 
exeq card is used: 

6 16 21 

MON$$ EXEQ MACROPRT, , , xyz, NOPRT 

PRINT Card 

Only the print control card, other than the exeq card, 
is needed to run macroprt. The print card may be 
repeated and has the following format: 



EXPLANATION 

Not used. 

Make entry if the program is to list the 
name of each macro routine; otherwise, 
entry is blank. (This entry should ap- 
pear only on the first card of the control 
package. ) This parameter applies only 
to printed output. 



CAHD 




COLUMN 


CONTENTS 


1-5 


blank 


6-11 


HEADER 



30 



CARD 






GABD 




COLUMN 


CONTENTS 


EXPLANATION 


COLUMN 


CONTENTS 


12-15 


blank 


Not used. 




named 


16-20 


PRINT 


Identifies this card type. 






21-72 




The information in this field defines 
which macro routines are to be com- 




END 

name3 



pletely printed or punched, and whether 
or not cross referencing is to be made. 
The field may be left blank only if the 
name of each macro routine is to be 
printed. The first parameter to be entered 
is left-justified in column 21. If more 
than one parameter is placed in this 
field, the parameters must be separated 
by commas. No blanks may appear in or 
between parameters. 

CROSS CROSS, if entered, must be the first 
parameter. It directs the program to cross 
reference L characters in model state- 
ments on the printed output only. 

ALL ALL must be either the first or second 

(if CROSS is used) parameter if all 
macro routines in the Macro Library are 
to be printed or punched. 
Note: When this entry is used, the 
program will assume that there are no 
other entries in the operand. If the ALL 
entry is not used, macro routines for 
which information is desired must be 
specified in the sequence in which they 
reside on the library. Refer to "Macro 
Library Contents" for the sequence of 
the Macro Library. Examples of the 
specification of the macro routines to be 
included are given below. 

START All macro routines from the beginning of 
named the library up to and including nameS 
will be printed or punched, 

name? Only name? will be printed or punched. 
name4 All macro routines starting with name4 



EXPLANATION 

and up to and including named will be 
printed or punched, (named must phys- 
ically follow name4 in the library, ) 
All macro routines starting with name3 
and continuing through the end of the 
library will be printed or punched. 

Note: Because of the above parameter definitions, 
no macro instruction can have the names cross, all, 

START, or END. 

Example 1: Print the name of each macro routine. 

6 16 

HEADER PRINT 

Example 2: Print or punch the name and contents 
of each macro routine. 

6 16 21 

HEADER PRINT ALL 

Example 3: Print or punch the name, contents, and 
cross reference of each macro routine. 

6 16 21 

HEADER PRINT CROSS, ALL 

Example 4: Print or punch the contents of selected 
macro routines, from the beginning of the library 
through MACRA; skipping to and printing or punching 
MACRC; skipping to macrf; printing or punching from 
MACRF to MACRH; skipping to MACRN; and printing or 
punching from macrn to the end of the library, cross 
referencing each macro routine selected on the printed 
output. 

16 21 

PRINT CROSS, START-MACRA, MACRC, 
MACRF-MACRH, MACRN-END 
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Data Flow During System Generation Runs 



This section is optional (but recommended) back- 
ground reading that provides an over-all correlation 
between the files operated upon and the data flow re- 
quired to generate a system. 

This section graphically depicts the tape layout for 
the Master file, a typical sgf, and a typical sof. Most 
of the section summarizes over-all data flow for the 
System Generation of a tape- or disk-oriented system. 



Tape Layout 

Figure 14(A) depicts the Master file. It shows the 
operating section and the three libraries. 

Figure 14(B) is a typical sgf layout. This reel of 
tape serves as the "Master file" for a particular instal- 
lation. The operating section of the sgf consists of a 
System Monitor tailored to the specific machine envi- 



ronment of the installation, and those programs re- 
quired for System Generation. 

The three types of libraries on the Master file may 
be transferred to the sgf. During this process the user 
may add to, delete from, and modify the libraries. 

Figure 14(C) is a typical sof layout. The System 
Monitor of the sof may be copied from the sgf or gen- 
erated for specific features. The rest of the sof con- 
sists of programs in absolute format and any library 
subprograms that the user has transferred from the 
SGF or has constructed. 

Over-all Data Flow — Tape System 

Figure 15 shows over-all potential data flow for the 
System Generation of a tape-oriented system. All of the 
capabilities are not necessarily used in a typical Sys- 
tem Generation. The source file shown in the figure 
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* Refer to "Creation Charts." 
** Refer to "Relocatable Library Contents. 
*** DIRl Is the directory of phase nomes. 
DIRS is the Macro Library directory. 



C. A Typical SOF Copied from the SGF, with Insertion of 
Multiple Transitional Monitors for Tape Systems Only 



Figure 14. The System Files 
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Macro Instrucfions and 



Subprograms 




NOTE; 

LLCC = Linkage Loader Control Cards 



Figure 15. Steps in the Generation of a Tape System 
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may be a Master file, sgf, or sof. Each major step in 
the figure is explained below. 



PROGRAM 

BEING 
EXECUTED 



ACTION PERFORMED 



PROGRAM 

STEP BEING 

EXECUTED 

1 AUTOCODER Autocoder produces relocatable sub- 

programs on the Go file. 

2 SGI SGI copies and/or updates libraries 

from the source file. New libraries also 
may be created. Input is from the SIU 
or, in the case of relocatable libraries, 
may also come from the Go file. Out- 
put consists of libraries on MWl. 

3 SGI SGI copies existing programs from the 

source file onto the Job file. A header 
for each program copied is written on 
MWl. If any library is to be placed 
onto the output tape, only a header 
indicating the location for the library 
is written on the Job file and MWl. 

4 SGI SGI transfers Linkage Loader control 

cards from the Create Library onto 
MW2. SGI also places on MW2 any 
Linkage Loader control cards or sub- 
programs encountered in the SIU. 

5 SORTDEFINE This program generates Linkage 

Loader control cards, from its input 
parameters, onto MW2. 

6 LINKLOAD Linkage Loader converts relocatable 

subprograms into absolute programs 
and places them on the Job file. Con- 
trol card input may come from the 
SIU or MW2. Relocatable input may 
come from a relocatable library on the 
source file, the Go file, the SIU, and/or 
MW2. Linkage Loader also produces 
a header on MWl for each phase it 
produces on the Job file. 
Note- Step 2, if used, must be performed only once 
during a System Generation run. Steps 3, 4, 5, and 6 
may be performed any number of times, and in any se- 
quence desired. The order of the new SGF or SOF (see 
step 7) is determined solely by the order of the elements 
on the Job file. 
Y SG2 SG2 must be the last program exe- 

cuted in any System Generation run. 
It performs two major functions. It 
first scans MWl. MWl contains all 
libraries and a header for every phase 
of each program on the Job file. From 
this information, it produces two di- 
rectories and writes them on MRO. If 
the Standard Print Unit is available in 
the system, this step also lists the 
names and order of the subprograms 
of each library, and the names and 
order of each program of the SGF or 
the new SOF. The second function is 
to copy the Job file to MW2, which 
contains the SGF or the new SOF. As 



ACTION PERFORMED 

it copies, it inserts directories from 
MRO and libraries from MWl when 
there are requesting headers. It also 
provides blocked, absolute-format rec- 
ords. 



Over-all Data Flow — Disk System 

Figure 16 shows over-all potential data flow for the 
System Generation of a disk-oriented system. All of the 
capabilities are not necessarily used in a typical Sys- 
tem Generation. The source file shown in the figure 
may be a Master file, sgf, or sof that has been loaded 
onto disk storage. Each major step in the figure is 
explained below. 



ACTION PERFORMED 



PROGRAM 
STEP BEING 

EXECUTED 

1 AUTOCODER Autocoder produces relocatable sub- 

programs on the Go file. 

Note: MW2 must be assigned to an 

area on the disk. 

2 SGI SGI transfers Linkage Loader control 

cards from the Create Library onto 
MW2. SGI also places on MW2 any 
Linkage Loader control cards or sub- 
programs encountered in the SIU. 
Note: MW2 must be a tape file dur- 
ing this and remaining operations. 

3 DSRTDEFINE This program generates Linkage 

Loader control cards, from its input 
parameters, onto MW2. 

Note: Steps 2 and 3 may be performed any number of 

times and in any sequence desired. 

4 LINKLOAD The Linkage Loader converts relocat- 

able subprograms into absolute pro- 
grams and places them on the Job 
file. Control card input may come 
from the SIU or MW2. Relocatable 
input may come from a relocatable 
library (LIB), the Go file, the SIU, 
and/or MW2. 

5 SG2 SG2 copies existing programs from the 

source file and the Job file onto the 
new output tape. 
Q SG2 SG2 copies and/or updates libraries. 

New libraries may also be created. 
Input is from the SIU or, in the case 
of relocatable libraries, may also come 
from the Go file. If the Standard Print 
Unit is available in the system, this 
step also lists the names and order of 
the subprograms of each library and 
the names and order of each program 
of the new SGF or the new SOF. 
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Masfer, 

SGF, or 

SOF on ( Source Fil 

Disk 

N, 




NOTES: *Must be a tape file 

LLCC = Linkage Loader Control Cards 

Figure 16. Steps in the Generation of a Disk System 
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System Description Control Cards 



This section contains the control cards that define the 
type of system desired by the user. The cards are 
source statements to the Autocoder processor. Auto- 
coder, through its macro-instruction facilities, uses the 
statements to select the modules required to create 
the desired Monitor and Resident iocs. 

The following Autocoder rules apply to the format 
of these macro statements: 

1. The macro name is written in columns 16-20 
(left- justified). 

2. The parameters (operands) are written begin- 
ning in column 21. 

3. The parameters are separated by commas. 

4. Blanks are not permissible within a parameter. 

5. Omitted parameters must be indicated by writ- 
ing the comma that would have followed the param- 
eter. (This rule does not apply if the omitted pa- 
rameter would have been the last on the card.) 

The macro statements should be sequenced by the 
user in the order in which they are described in this 
section. The genu macro is required whether or not 
Tele-processing capabilities are desired with the sys- 
tem. 

SPOOL Definitions (SPLDF) 

The SPLDF macro statement is used to specify the in- 
clusion of routines in the iocs to handle the spool 
(Simultaneous Peripheral Operation On Line) feature. 
This macro statement must be the first macro state- 
ment in the generation deck. A separate spldf macro 
statement must be made for each channel for which 
spool operations are desired. If no spldf macro state- 
ment is included, spool capabilities will not be avail- 
able. 

Note: General information on the spool feature is 
contained in the publication System Monitor, Form 
C28-0319. 



PARAM 

ETER 
3 



CON- 
TENTS 

nnnnn 



EXPLANATION 



PARAM- 
ETER 
1 



CON- 
TENTS 

lor 2 



CRD 
ALL 



EXPLANATION 

Channel number to which the Unit 

Record device(s) used for SPOOL are 

attached. 

SPOOL operations will use only IBM 

1402 Card Read Punch. 

SPOOL operations will use IBM 1402 

Card Read Punch and IBM 1403 

Printer. 



Size of reserved area in Resident Mon- 
itor for user-written editing routine. 
4 I/O The user-written editing routine re- 

quests input/output operations. (In- 
clusion of this parameter causes gen- 
eration of the Extension of IOCS.) 
blank The user-written editing routine re- 

quests no input/output operations. 

Three types of spool operations are available. The 
type selected determines which parameters of the 
spldf macro statement are to be used. The three types 

are: 

Type I: This type of spool implements normal op- 
eration with no blocking, deblocking, or editing of 
records. Parameters 1 and 2 of the spldf macro state- 
ment must be used; parameters 3 and 4 cannot be 
used. The statement below could be used to specify 
a Type I spool operation: 

16 21 

SPLDF 1,CRD 

This statement specifies that spool operations on 
channel 1 will use only the ibm 1402 Card Read 
Punch for unit record equipment. 

Type 11: This type of spool permits operations that 
include user-written editing routines (for blocking, 
deblocking, etc.); these user-written routines cannot 
request input/output operations. Parameters 1, 2, and 
3 of the spldf macro statement must be used; param- 
eter 4 cannot be used. The statement below could be 
used to specify a Type II spool operation: 

16 21 

SPLDF 2, ALL, 05678 

The statement specifies that spool operations on chan- 
nel 2 will use the ibm 1402 Card Read Punch and the 
IBM 1403 printer; a user-written editing routine (not 
to exceed 5,678 core locations) may be used. 

Type III: This type of spool permits including user- 
written editing routines (for blocking, deblocking, 
etc.). The user-written editing routines can request 
input/output operations. All parameters of the spldf 
macro statement must be used; no parameter may be 
omitted. The following statement could be used to 
specify a Type III spool operation: 

16 21 

SPLDF 1, CRD, 08000, I/O 
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The statement specifies that spool operations on chan- 
nel 1 will use only the ibm 1402 Card Read Punch; a 
user-written editing routine (not to exceed 8,000 core 
locations in size) may be used; the editing routine 
can request input/output operations. 

Note: The Extension of iocs must be generated in 
the Resident iocs if a user-written editing routine is 
to request input/output op(3rations. Use of the fourth 
(i/o) parameter of the spldf macro statement causes 
generation of this extension. The Extension of iocs is 
also generated for any system including Tele-process- 
ing programs. Thus, if the user intends to generate a 
Tele-processing system and has specified Type II spool 
operation, he can request input/output operations in 
his user-written editing routines. 

For Types II and III spool, the Autocoder source 
program for the editing routine can be assembled 
after the generation macro statements by including an 
EXEQ AUTOCODER Card (with columns 6-15 blank) and 
the source deck comprising the user-written editing 
routine after the end card for the macro statements. 
The relocatable user-written editing routine will be 
placed onto the Go file for subsequent access by the 
Linkage Loader. In calling the routine, the user must 
include a prtct 00000 card immediately following the 
first phase card for the routine, and a prtct card 
(with blank operand field) after the last end card 
for the routine. The control cards needed to generate 
a system including Type II and/or Type III spool 
are shown in Figure 17. (See "Use of Linkage 
Loader" in the publication IBM 1410/7010 Operating 
System; System Monitor, Form C28-0319.) 

To include a user-written editing routine that is in 
relocatable form in the Library, the additional exeq 
autocoder card and the edit routine source deck are 
omitted. 

If the edit routine is to be made available on the 
siu in relocatable form, the above procedure must be 
followed. In addition, the calln card is removed 
and replaced with the relocatable module. 



Physical Unit Definitions 

Unit-Record Devices (GEN01) 

The GENOi macro statement is used to declare the unit- 
record devices available to the system and to give each 
of them an assignment symbol. An assignment symbol 
(ss) can be any two alphameric characters unique 
(within the system) to the device it is identifying. 



6 

MONS» 

MONS$ 

HON%% 

MONS$ 

MON»S 

MON»» 

MONSS 

MON*S 

MONSS 

MONS* 
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21 



MONSS 
MONSS 



DATE YROAY 

aIgn SwKB4^^ ^''"^ ORIENTED SGF INCLUDING SPOOL TYPE 3 

ASGN MWa^AS 

ASGN MW3.BS 

ASGN MJB.At 

ASGN MR0.A3 

ASGN MG0.B2 

MODE GO.SG 

EXEQ AUTOCODER, . .NOFLG.NOPCH 

HEAOHGENERATE SGF 

SPLDF 1 .ALL. 0700 0. I/O 

GENOIPI ,R1 ,xi 

GENgl}J°°°'°"'--"-^-°^^-*°-"'---^'-5»".B6.SNAP 

GEN1010,A4,B4.A5,B5.A6 
GENU 

DEVOFl, 729, 1402, 1403 - 
DEVOF2,7330 

10KDF1410.,A.4,5 70000 

END .....uuuu 

EXEQ AUTOCODER 

TITLEUSERPROG 
USER PROGRAM SYMBOLIC CARDS • 

END 

EXEQ SGI 

LOCATC.CREATLIB ' 

INSERC 

LOCATR.IBMLIBR 

INSERR 

LOC ATM. AUTOCODER 

INSERM 

END 

CREATTSYSTEM 

PHASEUSEREDI r 

CONGO 

PRTCTOOOOO 

CALLNUSERPROG 

PRTCT 

END 

EXEQ LINKLOAO 

INPUTMW2 

EXEQ SG2 , , 

END 1-7 



SS 

ss 
ss 

ss 
ss 
ss 



Figure 17. Control Cards for a Tape-Oriented sgf Including 
Type III SPOOL 



PARAM- CON- 
ETER TENTS EXPLANATION 

Channel 1 Assignment Symbols (ss) 
1403 Printer 
Card Reader 
Card Punch 
Channel 2 Assignment Symbols 
1403 Printer 
Card Reader 
Card Punch 
Channel 1 Paper Tape Reader Assign- 
ment Symbol 
' ss Paper Tape Reader 

Channel 2 Paper Tape Reader Assign- 
ment Symbol 
^ ss Paper Tape Reader 

The following statement could be used to describe 
a system with a 1403 Printer and 1402 Card Read 
Punch on channel 1, and an 1101 Paper Tape Reader 
on channel 2: 

16 21 

GENOI P1,R1,X1,,,,,PT 

Tape Units (6EN02) 

The GEN03 macro statement is used to declare the tape 
units available to the system. A separate genos state- 
ment must be made for each channel. 



PARAM- 
ETER 
1 



CON- 
TENTS 
/MDM/ 



EXPLANATION 

Use this parameter if the system will 
include the Core Image file (see 
GEN08). If included, this parameter 
must be used in the GEN02 statement 
for each channel. This parameter must 
be specified if Checkpoint and/or the 
Storage Print utihty program are de- 
sired. 
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PARAM- 
ETER 

2 



CON- 
TENTS 



EXPLANATION 

Channel number for the units declared 
in this statement. 
3 ss Assignment symbol for unit in the 

channel specified in parameter 2 of 
this statement. 
4-12 ss, ( etc. ) Assignment symbols for units 1 through 

9 on the channel specified in param- 
eter 2 of this statement. (No skipping 
of unit numbers is permitted - that is, 
"ss„ss" is an invalid entry. ) 

The following statements could be used to declare 
a Core Image file, five tape units on channel 1, five on 
channel 2, and three on channel 3: 

16 21 

GEN02 /MDM/,1,A0,A1,A2,A3,A4 

GEN02 /MDM/,2,B0,B1,B2,B3,B4 

GEN02 /MDM/,3,C0,C1,C2 



Disk Areas (GEN03-GEN06) 

The macro statements genos through genog are used 
to define physical units in disk storage. The four 
macros apply, respectively, to disk modules on chan- 
nels 1 through 4. The information given below is ap- 
plicable to all four macros; the only distinction be- 
tween them is the channel identification established 
by the macro name. 

EXPLANATION 

Assignment symbol for the area de- 
fined by the next two parameters. 

2 amtttthr a — access mechanism, 
m — module number, 
tttt — starting track address, 
hr- two-digit identifier of the track 

(HA2) or of the appropriate rec- 
ord area on the track. 

3 eeee Ending track address. 
4.45 ss, The pattern of parameters 1-3 is re- 
peated for each disk area defined 
within the module(s) on this chan- 
nel. Three areas can be defined per 
card; fifteen areas can be defined per 
macro statement ( see below ) . 



PARAM- 


CON- 


ETER 


TENTS 


1 


ss 



ss, 

amtttthr, 

eeee, 

(etc.) 



Special Considerations 

1. Each of these macro statements (genos-genog) 
can consist of one card containing the macro name in 
columns 16-21, immediately followed by one through 
four continuation cards. (Continuation cards differ 
only in that columns 16-21 are left blank.) Since three 
areas can be defined per card, fifteen areas can be de- 
fined per macro statement. If more than fifteen areas 
are to be defined in the modules on a particular chan- 
nel, then the macro statement for that channel must 
be repeated. For example, if twenty areas are to be 



defined in modules and 1 on channel 2, two geno4 
macro statements are required. (The first would con- 
sist of five cards defining fifteen areas, and the second 
would consist of two cards defining the other five 

areas. ) 

2. Although each area defined must be entirely con- 
tained within one module, there is no restriction 
against defining, by one macro statement, areas within 
different modules. 

3. Autocoder can process a maximum of ninety-nine 
GENOi through GEN07 macro statements. This factor 
should be considered in determining whether to begin 
a new macro statement or to use continuation cards 
for definition of disk areas. (Only cards with a macro 
name in columns 16-21 count toward the limit of 
ninety-nine. ) 

Example 

The following statements could be used to define four 
areas in module on channel 1, two areas in module 1 
on channel 1, and two areas in module on channel 4: 

16 21 

GEN03 EA,001543AA,1943,EB,002700BA,3150, 
EC003543AA,3943,ED,004700BA,5150, 
GA 010000AA,5000,GB,010000BB, 5000 

GEN06 KA,005000AA,7500,KB,005000BB,7500 



1311 Disk(GEN07) 

The GEN07 macro statement is used to define physical 
units on 1311 disk drives. This macro statement per- 
forms the same functions for 1311 Disk Storage units 
that the geno3-geno6 statements perform for 1301 and 
2302 Disk Storage units. 

The GEN07 macro statement defines physical units 
in two ways: 

1. It defines a physical unit in terms of a disk drive 
number, a beginning sector address, and an ending 
sector address. The beginning sector address is known 
as the lower limit, and the ending sector address is 
known as the upper limit. In this case, the physical 
unit consists of the sectors starting at the lower limit 
and continuing through the upper limit. This type of 
physical unit is called an unlabeled physical unit. 
It is analogous to a 1301 physical unit. ; 

2. It defines a physical unit in terms of the disk 
drive number and the label for a specified portion 
of the disk pack. In this case, the beginning and end- 
ing sector addresses of the physical unit are taken from 
the header label. This type of physical unit is called 
a labeled physical unit. 

Either a labeled or an unlabeled physical unit can 
be associated with a file that is to be processed either 
sequentially or nonsequentially. However, for a non- 
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sequentially processed file, the definition of the physi- 
cal unit is used only to determine the channel num- 
ber. Sector limits and labels serve no useful purpose 
with a nonsequential file, since the disk address of 
each record to be processed must be provided by the 
programmer. 

Parameters 1 and 2 in the operand field of the state- 
ment must be entered as the first two operands in 
each GEN07 macro statement. The first two parameters 
are followed by groups of three parameters, with 
each group defining a physical unit. The contents of 
parameters 3, 4, and 5 differ when defining an un- 
labeled or a labeled physical unit, as indicated in 
the following listing: 



PARAM- 
ETER 



CON- 
TENTS 

1311 



EXPLANATION 



For an unlabeled unit: 
3 ss 



dmmmmmm 



This entry specifies that the physical 
unit is being defined on a 1311 disk 
drive. 

This number specifies the channel to 
which the disk drive bearing the disk 
pack is attached. The entry can be 
either 1 or 2, since 1311 disk drives 
can he attached to only channel 1 
or channel 2. 

The two-character assignment symbol 
that is to be associated with the disk 
area defined in the next two param- 
eters. 

d— the alternate drive-code digit for 
the disk drive on which the disk pack 
is located. The digit is either 0, 2, 4 
6, or 8. 

mmmmmm-the six-digit starting sec- 
tor address. 

The low-order five digits of the end- 
ing sector address. This five-digit ad- 
dress is interpreted as though it were 
preceded by a zero. 

The two-character assignment symbol 
that is to be associated with the disk 
area defined by the next two param- 
eters. 

4 d The alternate drive-code digit for the 

disk drive on which the disk pack is 
located. The digit is either 0, 2, 4, 6 
or 8. 

5 nn The two-digit label number (00-18) 

that indicates the position of the 
label in the label track on the disk 
pack. The label must contain the sec- 
tor address limits for the physical 
unit. 

The pattern of operands 3, 4, and 5 is repeated 
throughout the remainder of the macro statement. 
Groups defining labeled and unlabeled physical units 
can be intermixed on the same card. 

The coding in the example below defines the entire 
disk pack on drive of channel 1 as an unlabeled 



nnnnn 



For a labeled unit: 
3 ss 



physical unit. In addition, the macro statement defines 

six labeled physical units on the disk pack. 

16 21 

GEN07 1311,1,DA,0000000,19999,DB,0,00 
DC,0,01,DD,0,02,DE,0,03,DF,0,04, 
DG,0,05 

Monitor Dermitions (GEN08) 

The GEN08 macro statement is used to specify system 
information that aflFects the construction of the Moni- 
tor. 



PARAM- 
ETER 
1 



CON- 
TENTS 

dcfltmwpra 



EXPLANATION 



d — Data Processing System 

1 1410 

7 7010 
c - Core-Storage Size ( highest address 
of the machine ) 

3 39999 

5 59999 

7 79999 

9 99999 
f — SOF Residence 

Tape 

9 Disk 
I — System File Tape Labels 

No labels 

1 Standard 80-character labels 

2 Standard 120-character labels 
Note: During System Generation for a tape-oriented system, 

a labeled source System Generator file cannot be used to pro- 
duce an unlabeled output System Generator file. 

t — Tele-processing Supervisor 

Monitor does not include the 

Tele-processing Supervisor. 
9 Monitor does include the Tele- 
processing Supervisor, 
m — Core Image File 

System does not include Core 

Image File. 
9 System does include Core 
Image File. 
w — POW Program 
Not included 

9 POW program included for 
Standard Print and/or Stand- 
ard Punch Units, if those units 
are tape or if Variable Print 
and Variable Punch are cho- 
sen. If both units are Unit 
Record, or both units are 
omitted (specified as "none"), 
or either combination of Unit 
Record and "none" is speci- 
fied the POW program can- 
not be included. (A descrip- 
tion of the POW program is 
in Operator's Guide, Form 
C28-0351.) 
p — Standard Print Unit 

None 

1 1403 Printer 

2 Tape unit 

3 Variable unit 

Note: If Variable Print is chosen, then Variable Punch 
must also be chosen. (See "System File Sharing and Device 
Switching Feature" in the publication System Monitor. ) 
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PARAM- CON- 
ETER TENTS 

r — Standard Punch Unit 

None 

1 Unit-record punch 

2 Tape unit 

3 Variable unit 

Note- If Variable Punch is chosen, then Variable Print must 
also be chosen. (See "System File Sharing and Device Switch- 
ing Feature" in the publication System Monitor. ) 
a — Alternate Input Unit 
None 
9 AIU capability is included. 

2 nnnnn Tele-processing System; Area Reserved 

nnnnn - Number of core-storage posi- 
tions to be reserved perma- 
nently for TP programs. (If 
no area is reserved, this pa- 
rameter is omitted. ) 

3 nn Lines-Per-Page 

Number to be stored in Resident 
Monitor's Communication Region at 
/LIN/. A two-digit entry must be 
made whether or not the Standard 
Print Unit is specified. (00 is a valid 
entry. ) 

4 n or nn Console Input Area 

This parameter specifies the number 
of core-storage positions to be re- 
served in the Resident Monitor as the 
console input area: 5-20. For Tele- 
processing systems, the parameter 20 
will be assigned automatically. If the 
File Organization System is used, a 20 
must be specified. 
5 jmt Control Card Recording 

j — JOB Card Punching 

JOB cards are not to be re- 
corded on the Standard Punch 
Unit. 
9 JOB cards are to be recorded 
on the Standard Punch Unit. 
m — Monitor Control Cards — 
Standard Print Unit 
Monitor control cards, exclud- 
ing the JOB card, arc not to 
be recorded on the Standard 
Print Unit. 
9 All Monitor control cards are 
to be recorded on the Stand- 
ard Print Unit, 
t — Monitor Control Cards-Console 
Monitor control cards are not 
to be recorded on the console 
printer. 
9 All Monitor control cards are 
to be recorded on the console 
printer. 
Note: It is recommended that all 
Monitor control cards be recorded 
on the console printer so that 
diagnostic messages can be read- 
ily associated with the error con- 
ditions. 
6.14 Assignment Symbols (See Note) 

6 ss System Operating file (required) 

7 ss Standardlnput Unit (required) 

8 ss Alternate Input Unit (optional) 

9 ss System Library file (optional) 

10 ss Standard Print Unit (optional) 

11 ss Standard Punch Unit (optional) 

12 ss TP Library file (optional) 



PARAM- CON- EXPLANATION 

ETER TENTS 

13 SS Temporary Storage file (optional) 

14 ss Core Image file (optional) 

Note- Parameters 10, 11, and 14 are classified as optional; 
however, if these system files are included, and if they are not 
assigned by this macro statement, ASGN cards for these faies 
must precede the first JOB card during initialization of the 
system. . , 

Parameters 8, 9, 12, and 13 are also classified as optional; 
these files, if included at the installation, may be assigned dur- 
ing initialization or any time prior to their use by the system. 
Furthermore, 12 and 13 must be assigned before the TP com- 
plex is opened. 

15 SNAP Use this parameter if the Snapshot 

capability is to be included in the 
Resident Monitor for unusual end of 
program. (Dependent program un- 
usual-end-of-program situations will 
cause a Snapshot of all of core stor- 
age.) Otherwise, omit the parameter. 

16 ^ This parameter is reserved for system 

expansion. Currently it is to be omitted. 

17 HALT Use this p;arameter to cause a halt in 

the Resident Monitor Wait-Loop 
(/WAT/) routine. 

18 camtttthh This parameter is specified only if the 

File Organization System will be used. 
The parameter indicates the beginning 
track address of the File Organization 
System File Directory and Index area, 
"c" is the channel, "a" is access mech- 
anism, "m" is the module, "tttt" is the 
track number, and "hh" is the home 
address. 
If a continuation card for gen08 is needed, columns 16-21 
should be left blank. 

Symbolic Unit Definitions 

The nvimber of reserve units, work units, and Tele- 
processing units to be included in the Monitor's as- 
signment tables are specified in three macro state- 
ments (GEN09, GENio, and genu). Selection of these 
symbolic units depends, in part, upon the nature of the 
object programs to be executed. Autocoder programs 
can refer to all three types of symbolic units, cobol 
programs can refer to work or reserve units. Fortran 
programs can refer to only work units. Thus, the user 
must ensure that symbolic units are provided for both 
general system functions and object-program func- 
tions. For example, if a Fortran object program is to 
address Fortran unit 4, MWi (the equivalent symboHc 
work file - see FORTRAN publication) must be speci- 
fied in the genio macro statement. 

Reserve Units (GEN09) 

The GEN09 macro statement specifies the number of 
reserve units whose names are to be included in the 
Monitor's assignment tables. The names will be as- 
signed to the reserve units sequentially, first numeri- 
cally and then alphabetically. (That is mro, mri, . . . 

MR9, MRA, MRB, . . . MRZ.) 



40 



PARAM- 
ETER 
1 



CON- 
TENTS 

n or nn 



EXPLANATION 



Note; 



Number of reserve units: 1-36. (Note 
that the number "7" makes available 
symbolic units and names MRO 
through MR6, not MR7. ) 

At least one reserve unit must be defined for 
subsequent use by System Generation. 

Work Units (GEN 10) 

The GENio macro statement specifies the number of 
work units whose names are to be included in the 
Monitor's assignment tables. The names will be as- 
signed to the work units st^quentially, first numerically 
and then alphabetically. (That is, mwo, mwi, . . 

MW9, MWA, MWB, . . . MWZ. ) 



PARAM- 
ETER 

1 

2-37 



CON- 
TENTS 

n or nn 
ss, (etc.) 



EXPLANATION 



J!V«mfoer of work units: 1-36 
Assignment Symbols: Entries in pa- 
rameters 2-37 are optional. If made, 
they serve the same functions as an 
ASGN card. Assignment symbols will 
be supplied to work units as follows: 

MWO parameter 2 

MWI parameter 3 

MW2 parameter 4 

etc. 

Note: At least one unit should be left unassigned 
for subsequent use by System Generation. 

Tele-processing System Units (GENT 1) 

The GENU macro statement is used to specify the 
number of Tele-processing system units to be included 
in the Monitor's assignment tables. The names of 
these units will be assigned sequentially, first numer- 
ically and then alphabetically. (That is, mto, mti, . . , 

MT9, MTA, MTB, . . . MTZ. ) 

Note: This macro statement must always be made. 
For installations not including a tp system, the oper- 
and field must be blank. 



EXPLANATION 

Number of Tele-processing system 
units: 1-36 

Assignment Symbols: Entries in pa- 
rameters 2-37 are optional. If made, 
they s(;rve the same functions as an 
ASGN card. Assignment symbols will 
be applied to the Tele-processing sys- 
tem units as follows: 

MTO parameter 2 

MTI parameter 3 

MT2 parameter 4 

etc. 



Tele-processing Directory De/i n/ff ons (TPDIR) 

The TPDIR macro statement is used by the tp Super- 
visor to reserve the appropriate amount of core stor- 



>ARAM- 


CON- 


ETER 


TENTS 


1 


n or nn 



2-37 



ss, (etc.) 



age for the tp Directory. This macro must be issued 
by the user at System Generation and is usually placed 
at the end of the macro packet. This statement is used 
only by installations including a tp system. 



EXPLANATION 

The total number of user programs 
resident in the TP Library. 
The maximum number of TP pro- 
grams the user will have in TP core 
storage at any one time. 



PARAM- 


CON- 


ETER 


TENTS 


1 


XXX 



yyy 



Device Definitions for Resident IOCS (DEVDF) 

The DEVDF macro statement defines the channel orien- 
tation of all input/output devices (except ibm 1301 
and IBM 2302 Disk Storage units) included in the sys- 
tem. One macro statement must be included for each 
channel containing any of the devices indicated by 
parameters 2 through 8, below. The dskdf macro 
statement must be used to indicate the channel orien- 
tation of IBM 1301 and 2302 Disk Storage units. 



PARAM- 
ETER 
1 



CON- 
TENTS 

1,2, 3, or 4 



EXPLANATION 



729 



7330 



1402 or 1442 



1403 



Channel number of devices described 
in this card (one macro per card). A 
separate macro statement is used for 
each channel. 
Tape Unit Type 

If 729 magnetic tape units are the 
only type of tape unit attached to this 
channel. 

If one or more of the tape units at- 
tached to this channel is an IBM 7330. 
Card Reader/Punch 
If an IBM 1402 Card Read Punch or 
1442 Card Reader is attached to this 
channel. 
Printer 

If an IBM 1403 Printer is attached to 
this channel. 
Paper Tape Reader 

If an IBM 1011 Paper Tape Reader is 
attached to this channel. 
Tele-processing Devices 
If an IBM 1009, IBM 1014, IBM 
1050, IBM 7770, or a telegraph de- 
vice is attached to this channel. 
If a PTC unit is attached to this chan- 
nel. 

If present, this parameter indicates the 
number of IBM 1311 Disk Storage 
Drives attached to the channel. This 
parameter must not be used to pro- 
vide information on IBM 1301 or 
IBM 2302 Disk Storage units. 
SI, S2, S3, S4, The letter S is used as a prefix to the 
or S5 number of drives to indicate that the 

scan disk special feature is being 
used. 

The following statements would be used to describe 
a system that has 729 tape units, a 1402 Card Read 
Punch, and a 1403 Printer on channel 1, telegraph 



1011 



TP 



PTC 



8 1, 2, 3, 4, or 5 



(10) 
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devices and 7330 tape units on channel 2, and a mix- 
ture of 729 and 7330 tape units on channel 3: 

16 21 

DEVDF 1,729,1402,1403 
DEVDF 2,7330„„TP 
DEVDF 3,7330 

IBM 1301/2302 Disk Definitions for Resident IOCS 
(DSKDF) 

The DSKDF macro statement is used to specify the num- 
ber and channel orientation of the disk modules avail- 
able to the system. (Another function of this macro 
is discussed under the explanation of parameters 3-21. ) 
One statement is to be made for each channel to which 
disk modules are attached. 



PARAM- 
ETER 



CON- 
TENTS 

1, 2, 3, or 4 



EXPLANATION 

Channel number for modules on this 
card. 

Note: To obtain a shared-file IOCS 
generation, the channel number must 
have a prefix of the type of the gen- 
eration desired (A, B, C, or D, ex- 
plained under "Shared Disk Files"). 
For example, the channel entry for a 
channel 1 IOCS generation with no 
arm-sharing abilities would be Al. 

2 00 AccesS'Mechanism/Module 

The entry in parameter must be for 
access mechanism 0, module 0. 

3-21 am The entries in parameters 3-21 may 

be in any order. The following 
should be considered in determining 
the order: during the execution of 
object programs, the IOCS will, for 
each channel, determine the availabil- 
ity of an access-mechanism/module 
combination before issuing a Seek 
Disk or any other disk input/output 
instruction. The order in which the 
availability is tested is the order in 
which the parameters appear in pa- 
rameters 2-21. Thus, "00" is always 
tested first, next the combination in 
parameter 3, and so on.. 

The following statements could be used for a system 
with four modules of disk storage on channel 2, and 
two modules on channel 3: 

16 21 

DSKDF 2,00,01,02,03 

DSKDF 3,00,01 



IOCS Definitions (lOKDF) 

The lOKDF macro statement is used to specify the in- 
clusion of certain iocs routines to meet the require- 
ments of the system's dependent programs. This macro 
statement must immediately follow the devdf and 
DSKDF macro statements. 



PARAM- 
ETER 

1 

2 



CON- 
TENTS 

1410 or 7010 



B 



D 



mn 



NSEQ 



EXPLANATION 

Machine type 

80-Character Tape Label Routines 
No exits will be used by dependent 
programs. 

Exits A, D, G, and N, and return 
points /LRC/, /LRF/, /LRM/, and 
/LRR/ will be used by dependent 
programs. Reading, writing, and check- 
ing functions are not to be provided 
by the IOCS. 

All exits except C, F, J, L, and Q, and 
all return points except /LRB/, /LRE/, 
/LRH/, /LRK/, and /LRP/, will be 
used by dependent programs. Reading 
and writing, but not checking, func- 
tions are to be provided by the IOCS. 
All 80-character label routines are to 
be provided by the IOCS. 
If the Data File Generator is to pro- 
duce a labeled file, the "D" parameter 
must be specified. 
120-Character Tape Label Routines 
n is the letter A, B, C, or D, as speci- 
fied for parameter 2. If operand of 
C is given, 120-character label is read 
— but the following tape mark is not 
spaced over. 

Note: If both 80-character and 120- 
character label routines are to be in- 
cluded in the IOCS, then parameters 
2 and 3 must specify the same code 
letter. 

m is omitted if only those label rou- 
tines for 120-character tape labels are 
to be included in the IOCS, 
m is the number 1 if only those label 
routines for 100-character 1311 labels 
are to be included. 

m is the number 2 if label routines 
for both 120-character tape labels and 
100-character 1311 disk labels are to 
be included. 

n is the letter A, B, C, or D, as speci- 
fied for parameter 2. 
Error statistics are to be accumulated 
by the IOCS. 

Service routines will be included in 
dependent programs. That is, the 
DTF INTADDR entry will be used. 

This parameter applies only to a sys- 
tem with IOCS defined for 1311 Disk 
Storage. It is used if all DTF entries 
in the programs being used have 
NSEQ as the first operand of 
FILEFORM. Use of this operand will 
result in a smaller Resident Monitor. 
Disk files requiring specification of 
operands 2 and/or 3 of the DTF 
FILEFORM entry will be used by de- 
pendent programs. 

Write Disk Checks are to be taken. 
That is the WDC operand will be 
used in the DTF ERRCHECK entry. 

(This parameter is available for sys- 
tem expansion; currently, it is to be 
omitted. ) 
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PARAM- 
ETER 
10 



CON- 
TENTS 
XXXXX 



EXPLANATION 

Checkpoint functions will be required 
by dependent programs. The third 
record of each checkpoint triplet is to 
begin at location xxxxx. (This address 
will be stored in the Resident Monitor's 
Communication Region at lOGR.) 
This address must be provided if the 
IOCS checkpoint facilities and/or the 
Storage Print utility program are to be 
used. (Refer to GEN02 and GEN08 
macros. ) It is recommended that loca- 
tion xxxxx be about 8,000 positions 
below the top of core storage. 

Special Considerations for System File Labels 

If th(3 user specifies in the genos macro statement that 
system files are to have tape labels, then parameter 2 
or 3 must be specified in the iokdf macro to provide 
?t ^^^ routines for those labels. Furthermore, only 
"A" or "D" may be used in those parameters. 

Note: The Linkage Loader expects that the first 
eight characters of the phase name will be "linkload." 
Any two characters may follow, making the format 
"linkloadxx." If this format is not followed, the Link- 
age Loader will not build any symbol tables. 



PARAM- 


CON- 


ETER 


TENTS 


1-40 


ccm, ccm, 




(etc.) 



Random-Processing Disk Module Definitions 
(GENRM) 

The GENRM macro statement defines the disk modules 
that are to be made available for random processing. 
( Continuation cards may be used for this macro state- 
ment, if necessary. ) 



EXPLANATION 

"c" is the channel character of the ap- 
propriate x-control fields. (As shown, 
this must appear twice. ) 
"m" is the identifying module number 
(0-9). 

Note: The GENRM macro may be 
compiled by a separate Autocoder run. 
The resultant relocatable module must 
be combined as part of a program and 
loaded through the SIU. 
It is recommended that IBRANDOMl, 
which results from GENRM, be 
placed in the Relocatable Library be- 
tween the modules IBRANDOM and 
IBRAND0M2; however, it may be lo- 
cated wherever the user wishes. 
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System Generation Control Cards 



This section contains descriptions of the control cards 
that are used to direct the System Generation process. 
The control cards for programs that are unique to the 
System Generation function are described completely. 
The control cards for programs that are used for data 
processing as well as for System Generation and that 
are, therefore, documented in other publications, are 
described in this publication solely from the viewpoint 
of System Generation. 



Monitor Control Cards 

In addition to the functions and entries described in 
the publication. System Monitor, the Monitor exeq 
card can have the following entries that are unique 
for System Generation: 

1. In the EXEQ card for sgi (mons$ exeq sgi) : 



EXPLANATION 



CARD 
COLUMN 



CON- 
TENTS 



59 3, 5, 7, or 9 



EXPLANATION 

Indicates that the actual machine size 
being used for System Generation is 
other than that specified in the Moni- 
tor (at /AMS/) of the source file. 
This is intended primarily to specify, 
for the initial System Generation, that 
the machine has more than 40,000 
positions. 

3- 40K 

5- 60K 

7- 80K 

9 - lOOK 



2. In the exeq card for sg2 ( mon$$ exeq sgs ) : 



CARD 
COLUMN 

57 



CON- 
TENTS 



EXPLANATION 



any character Any character, except blank, indicates 
to SG2 that SGI only updated an al- 
ternate relocatable library and that the 
printed output of SG2 is to consist 
solely of names of the relocatable H- 
brary modules. If this column is blank, 
the SG2 printout will be a full listing 
of the SOF (or SGF) generated. 
(Italicized words above apply only to 
a tape-oriented system. ) 

58 any character Largest possible records are to be 
built. If this column is blank, the 
blocking factor for absolute-format 
programs is 2,165. Note that any en- 
try in this field, except blank, will 
override any specification given in the 
first PHASE card of a program. Sec 
the following description of the addi- 
tional entries that can be made in the 
Linkage Loader PHASE card. This 
column is not used for a disk-oriented 
system. 



CARD CON- 

COLUMN TENTS 

59 3, 5, 7, or 9 This must be the same as that 

punched in column 59 of the EXEQ 
SGI card described above. 

60 Tape labels on the new SOF (appli- 
cable only to tape-oriented systems): 

blank No labels 

1 80-character labels 

2 120-character labels 

Note: If tape labels are used, this 
EXEQ card must be immediately fol- 
lowed by a card specifying the infor- 
mation to be used in writing those 
labels: 
1 6 80 

IHDR (label information) 

The label information must conform 
to the IOCS standard label format. 
The field "File Identification" must 
contain IBMSYSTEMb. Refer to the 
publication, Basic Input/Output Con- 
trol System. (For 120-character labels, 
SG2 adds a 40-position blank field to 
the 80 characters taken from the card. ) 
This card is used only once: when 
changing to system file labels from a 
system that does not use file labels. 

Note: The mode sg Monitor control card must be 
included on the siu if the Linkage Loader is to be 
executed during a System Generation run. 



Linkage Loader Control Cards 

In addition to the functions and entries described in 
the publication, System Monitor, the Linkage Loader 
PHASE card may have the following entries that are 
unique to System Generation: 



CARD CON- 

COLUMN TENTS 

61 1 or 3 



EXPLANATION 



This entry indicates that a directory is 
to be inserted at this point. If the 
entry is "1", the Major Phase Direc- 
tory (Directory 1) is inserted. If the 
entry is "3", the Macro Library Di- 
rectory (Directory 3) is inserted. 
Note: The one Directory 1 request 
permitted for a disk system is re- 
served for the Transitional Monitor. 

62 M, R, or C This entry indicates that the macro 

Library, a Relocatable Library, or the 
Create Library is to be inserted at this 
point. ("R" applies only to a tape- 
oriented system. ) 

63 any character If this column is not blank, the abso- 

lute format records are "largest possi- 
ble." If the column is blank, then the 
size is 2,165 characters per record. 
("Largest possible" refers to tape- 
oriented systems only. ) 
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SG Control Cards 

The remainder of this section describes the control 
cards used to perform library maintenance functions 
with the SGI and sgs programs. These cards (here- 
after termed SG control cards) are divided into four 
classes, in accordance with the type of library for 
which they are used. (Class i is an exception, in that 
the one card in this class applies to all three library 
types. ) 

In the following material the term sgfx refers to the 
file from which the System Generation is being per- 
formed - which can be the Master file, an sgf, or an 
soF. The term SGFy refers to the new file being created 
by the System Generation - which can be either an 
SGF or an sof. 

Tables are provided at the end of this section to 
show the grouping of the sg control cards for presen- 
tation to SGI and sgs, and to summarize the library 
maintenance functions and control card formats. 

Note: No SG control card may contain any punches 
in columns 1-5. 

Class I - The INCLD Card 

This card directs the System Generation programs to 
copy an entire program or library from sgfx to sGFy. 
16 21 

INCLD name 
The INCLD card has two functions. The specific func- 
tion performed is determined by the nature of the 
element named in the operand. 

If name is the identifier of an absolute format pro- 
gram on the System Generation source file (sgfx), the 
INCLD card directs the System Generator to copy the 
program onto either the Job file for a tape system or 
the output unit for a disk system. 

If name is the identifier of a Create or Relocatable 
Library on the sgfx, the incld card directs the System 
Generator to insert the library at this point on the 
SGFy. The library must have been previously refer- 
enced by a LOCAT card, and updated or copied. The 
placement of the Macro Library on the SGFy is con- 
tingent on the placement of the Autocoder processor. 
If the SGFy is disk-oriented, the Macro Library will be 
placed at the end of the absolute section. 

For example, to simply copy Autocoder from the 
SGFX to the SGFy, the following card would be used: 
16 21 

INCLD AUTOCODER 

Class II Control Cards — Macro Library 

Class II control cards pertain to all functions concern- 
ing the Macro Library. 



LOCAT Control Card (Class II) 

A LOCAT control card must be used to locate the Macro 
Library before a library maintenance function may be 
performed. This card must appear before any group 
of iNSER, REPLC, or DELET coutrol cards that pertain to 
the Macro Library. 

Columns 1 through 5 of the macro cards must be 
punched and these cards must be in ascending order. 
There are two forms of this card that pertain to 
the Macro Library: 

16 21 

LOCAT M,AUTOCODER 

16 21 

LOCAT M,MACROLIB 
The first card is used to locate the Macro Library 
on a tape-oriented sgfx. The second card is used to 
locate the Macro Library on a disk-oriented sgfx. 

INSER Control Card (Class II) 

The INSER card directs the System Generator to per- 
form maintenance on the total Macro Library or on 
some given macro. 
Format 1 

16 21 

INSER M 

This format of the inser card directs the System 

Generator to copy the entire Macro Library onto either 

Mwi for a tape system or the output unit for a disk 

system. This card must be preceded by the locat card. 

Format 2 

6 16 21 

alpha INSER M 

This format of the inser card directs the System 
Generator to copy to the end of the Macro Library 
and to insert the library element alpha at the end of 
the library. The new element must follow the inser 
card in the siu. 

Format 3 

6 16 21 

name INSER M,aaaaa 

This format of the inser card directs the System 
Generator to insert new statements after the state- 
ment with sequence number aaaaa in macro name. 

The new statements must follow the inser card in 
the siu. The statements of macro name are not re- 
sequenced. 

REPLC Control Card (Class II) 

Format 1 

6 16 21 

name REPLC M 

This format of the replc card directs the System 
Generator to replace macro name with a new element 
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of the same name. The element must follow the replc 
card in the siu. 
Format 2 

6 16 21 

name REPLC M,aaaaa,bbbbb 

This format of the replc card directs the System 
Generator to delete from macro name the statements 
with sequence numbers aaaaa through hbbhb, and to 
replace these with new statements. The new state- 
ments must follow the replc card in the siu. The state- 
ments of macro name are not resequenced by the 
System Generator. To replace a single statement, 
aaaaa is equal to bbhhb. 

The DELET Control Card (Class II) 

Format 1 

6 16 21 

name DELET M 

This format of the delet card directs the System 
Generator to delete the element name from the Macro 
Library. 
Format 2 

6 16 21 

name DELET M,aaaaa,bbbbb 

This format of the delet card directs the System 
Generator to delete statements aaaaa through bbbbb 
from macro name. To delete a single statement, aaaaa 
must equal bbbbb. No resequencing is performed by 
the System Generator. 

Class III Control Cards - Create Library 

The Class in control cards direct the System Generator 
to perform operations on the Create Library. 

The Create Library is a collection of Linkage Loader 
control card packets. Each packet has a name by 
which it can be called. When it is called, normally 
through the creat control card, the System Generator 
extracts the named packet from the library and places 
its contents on mws. mw2 must always be a tape unit, 
and the Linkage Loader must be informed that a 
Create packet has been selected. The user gives this 
information to the Linkage Loader via the input con- 
trol card. 

LOCAT Control Card (Class III) 

A LOCAT card must be used to locate the Create Li- 
brary before the library maintenance functions may 
be performed. This card must appear before any group 
of iNSER, REPLC, DELET, or GENER packcts that pertain 
to the Create Library. 

There is one form of the locat control card as it 
pertains to the Create Library: 

16 21 

LOCAT CCREATLIB 



INSER Control Card (Class III) 

The INSER card directs the System Generator to per- 
form maintenance functions on the total Create Li- 
brary, or on some given Create packet. 

Format 1 

16 21 

INSER C 
This format of the inser card directs the System 
Generator to copy the entire Create Library onto either 
Mwi for a tape system or the output unit for a disk 
system. The Create Library must be located by a 
LOCAT card immediately preceding the inser card. 

Format 2 

6 16 21 

name INSER C 

This format of the inser card directs the System 
Generator to copy to the end of the Create Library, 
and to insert the library element identified by name at 
the end of the library. 

GENER Control Card (Class III) 

Each packet in the Create Library is identified by a 
header label of the format shown below: 
16 21 

GENER name 

name is the identifying name of the packet (maxi- 
mum of 10 characters ) . 

When format 2 of the inser card or format 1 of the 
REPLC card is used, it must be followed by a gener 
control card. 

The GENER control card must, in turn, be followed 
by the packet of Linkage Loader control cards. 

To use this packet as Linkage Loader input during 
a generation run, the user must use a creat card with 
the same name as was given on the gener card. 

REPLC Control Card (Class III) 

Format 1 

6 16 21 

name REPLC C 

This format of the replc card directs the System 
Generator to replace the Create packet name with a 
new packet having the same name. The replc card 
must be followed, in the siu, by a gener card, and 
then the packet. 

DELET Control Card (Class III) 

Format 1 

6 16 21 

name DELET C 

This format of the delet card directs the System 
Generator to delete the packet name from the Create 
Library. 
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CREAT Control Card (Class III) 

The GREAT card directs sgi to access the Create Li- 
brary (creatlib) for Create packet name, to deblock 
the records of this packet into card-image records, and 
to transfer these card-image records to work file mw3, 
for later input to the Linkage Loader. The format is as 
follows : 

16 21 

CREAT name 

Note 1: mw2 must be a tape unit. 

Note 2: Linkage Loader must be presented with an 
INPUT MW2 control card. 

Note 3: See section, "Creation Charts," for a de- 
tailed hst of all Create packets supplied by ibm. 

Note 4: Linkage Loader control cards or object 
decks EQay be intermixed with great control cards and 
will be placed on mws in the order in which they are 
received. This allows the user to merge his own pro- 
grams into sequence with ibm programs. Other means 
are also provided for reordering an sgf once the pro- 
grams have been placed on the file in absolute format 
See "INCLD Control Card (Class I)." 



Class IV Control Cards - Relocatable Library 

Class IV control cards direct the System Generator to 
perform operations on a Relocatable Library. 

LOCAT Control Card (Class IV) 

The LOCAT card must be used to locate a particular 
library on the system file (sgf or sof) before the li- 
brary maintenance functions can be performed. 
Format 1 

16 21 

LOCAT B.,namel 
Referring to format 1, name identifies the hbrary. 
name must be left-justified in the operand field, and 
can consist of a maximum of ten characters. 

Format 2: The locat card can also be used to 
change the name of a relocatable library: 
6 16 21 

name2 LOCAT R,namel 

namel is the original name; name2 is the new name. 

ALTLB Control Card (Class IV) 

The ALT1.B card is used to locate the Relocatable Li- 
brary currently assigned as the System Library file 
(lib). This card performs the same functions for such 
Relocatable Libraries as does the logat card for any 
type of libraiy residing on the system file (sgf or sof). 
Note: If any Relocatable Library, except those re- 
siding on the sof (or sgf), is to be maintained, that 
library must be assigned to symbolic unit lib. Further- 



more, maintenance of this library is the only function 
that can be performed during this System Generation 
run. Also, see discussion of column 57, exeq sg3 con- 
trol card, under "Monitor Control Cards." 
Format 1 

16 21 

ALTLB xxxx 
Referring to format 1, the operand xxxx specifies 
the type of physical unit assigned to lib; this operand 
can be tape, 1301, or 2303. 

ADD Control Card (Class IV) 

The ADD card directs the System Generator to create 
header information for a new library. The add card 
must immediately precede, in the siu, the records that 
constitute the new library. 

16 21 

ADD R,name 
name is the identifying name that the new library 
is to have ( maximum of ten characters ) . 

INSER Control Card (Class IV) 
Format 1 

16 21 

INSER R 

This format of the inser card directs the System 
Generator to copy an entire Relocatable Library onto 
either mwi for a tape system or the output unit for a 
disk system. The library that is copied must be located 
by a LOCAT (or altlb) card immediately preceding the 
INSER card. 

Format 2 

6 16 21 

name INSER R 

This format of the inser card directs the System 
Generator to copy to the end of the Relocatable Li- 
brary being processed, and to insert the module (sub- 
program) name at the end of the library. The module 
can either follow the inser card in the siu or be on the 
Go file. If this format inser card is not followed by 
the module (that is, if the next card in the siu is an- 
other control card), the System Generator automatical- 
ly searches the Go file for module name. 

Format 3 

6 16 21 

namel INSER R,name2 

This format of the inser card directs the System 
Generator to insert module namel in front of module 
name2. If module namel does not follow the inser 
card in the siu, the Go file is searched. If more than 
one module (from the siu) is to be inserted at this 
point, they may follow the module packet for namel, 
without additional inser cards. 
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REPLC Control Card (Class IV) 
Format 1 

6 16 21 

name REPLC R 

This format of the replc card directs the System 
Generator to replace library module name with a new 
module having the same name. The module can either 
follow the REPLC card in the siu or be on the Go file. 
If this format replc card is not followed by the module 
(that is, if the next card in the siu is another control 
card), the System Generator automatically searches 
the Go file for the module. 
Format 2 

6 16 21 

namel REPLC B.,name2 

This format of the replc card directs the System 
Generator to delete modules namel through name2, 
and to replace the deleted modules with a single 
module whose identifier is namel. Note that one or 
more modules can be deleted but only one new 
module with namel can be added. If the new module 
namel does not follow the inser card in the siu, the 
Go file is automatically searched. 

DELET Control Card (Class IV) 

Format 1 

6 16 21 

name DELET R 

This format of the delet card directs the System 
Generator to delete module name from the Relo- 
catable Library. 



Format 2 

6 16 21 

namel DELET R,name2 

This format of the delet card directs the System 
Generator to delete modules namel through name2. 

Groups of Control Card Classes 

The four classes of sg control cards must be presented 
to SGI and/or sg2 in certain groups. The order and 
contents of these groups are determined, in part, by 
the orientation of the system file being used - whether 
it is tape- or disk-oriented. The table below defines 
the groups into which the various classes of sg control 
cards must be divided for proper control of the sgi 
and SG3 programs. 





TAPE 


DISK 


o 

I/) 


Group 1 

Classes II, III, IV 


Group 1 
Class III* 


Group 2 
Classes 1, III* 


Group 2 
None 


CN 

o 


Group 1 
None 


Group 1 
Class 1 


Group 2 
None 


Group 2 

Classes II, III, IV** 



* Of Class III cards, only the CREAT card may be used in this group. 
Linkage Loader control cards may be intermixed with the CREAT cards. 
** The Class IV cards must be last in this group. 

Each group must have the following card as its 

last card: 

16 
END 



SUMMARY nP 1 'RRARY MAINTENANCE: FUNCTIONS AND CONTROL CARDS 








— 


Library 

Maintenance 

Function 

Add an entire library 


Operation 16-20 
LOCAT 


Operation 16-20 
ADD 


Operation 16-20 
INSER 


Operation 16-20 
REPLC 


Operation 16-20 
DELET 


6-15 
Label 


21 

Ope 


-72 

rar 


d_ 


6-15 
Label 


21-72 

Operand 

0^1 


6-15 
Label 


21-72 
Operand 


6-15 
Label 


21-72 

Operand 

.„|L!-i \ 


6-15 
Label 


2 

Op; 


-n 

5ran 


d_ 


Delete an entire library 
Change name of a 
Relocatable Library 


13 


2 


12 


(o 


nission of c 


ont 


ol- 


:arc 


reference 


to a 


nor 


ary 
















— 


Copy of a library (no change) 
Add an element to end of 




1 


4 


— 




— 


— 




5 


1 




















Add a module to middle of 

a library 
Replace element from SIU 
Replace module from Go File 




2 
1 
1" 


4 
4 











— 




5 


2 


6 




5 
5 


1 
2 


— 


— 


5 


T" 




— 


Delete a library element 
Delete consecutive modules 
Replace several modules with 




1 
2_ 

2 


4 

4 

4 


— 




— 


— 












10 


2 


21 


— 


7 


X 


8 




Maintain external 

Relocatable Library 
Add statements to a macro 
Delete statement from a macro 
Replace macro statements 




T" 
3 
3 


(Lo 
4 
4 
4 


:at« 


with ALTl 


Be 


ird. 


N 


bintain wit 
5 


1 S< 


3 ca 
9 


rds_ 


as for libra 
5 


ry 
3 


vS> 

To" 


ste 

Ti 


mFile.) 


-T 


10 


11 



Key 1 . M,R, or C (library type) 

2. R only 

3. M only 

4. Library name 

5. Element name 

6. Name of module before which new module will be inserted 

7. First module to be deleted 



u. Last module to be deleted 

9. Number of statement behind which new statements 

will be inserted 

10. First element to be deleted or replaced 

1 1 . Last element to be deleted or replaced 

12. Original name 

13. New name 
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IBM Master File — Tape-Oriented System 



This section lists: (1) the assignment symbols that 
must be used by each user for his initial System Gen- 
eration run, ( 2 ) the programs available on the Master 
file, and (3) the construction of the basic Resident 
Monitor. I'his section applies only to a tape-oriented 
system and need not be read by persons interested in 
a disk-oriented system. 

Assignment Symbols for Initial Run 

Arbitrary assignment symbols have been chosen for 
use in the Master file. Therefore, the first run made 
by each user must be made on the basis of these as- 
signment symbols. For the initial run, mon$$ asgn 
cards must be prepared. These cards assign physical 
units to those duties specified under "Basic Concepts 
— Tape-Oriented System." 

The symbols available for assignment to the physi- 
cal units for the initial System Generation run are 
listed as follows: 





CHANNEL 1 


CHANNEL 2 




ASSIGNMENT 


ASSIGNMENT 


PHYSICAL UNIT 


SYMBOLS 


SYMBOLS 


Card Reader 


*R1 


R2 


Printer** 


**P1 


*»P2 


Punch 


**X1 


**X2 


Tape (729 or 7330) 


AO 


BO 




Al 


Bl 




A2 


B2 




A3 


B3 




A4 


B4 




A5 


B5 




A6 


B6 



*R1 is assigned as the SIU, but the unit assigned as SIU can 
be changed from the console. AO is assigned as the SOF, but 
the unit assigned as SOF can be changed from the console. 
**The Variable Print and Punch routines are included but are 
not preassigned. They can be assigned to either unit-record 
or tape devices. 

Programs Available 

The programs available on the Master file for a tape- 
oriented system are: 

IBBOOT 

IBRESMON 

IBTRANSIT 

LINKLOAD 

IBMLIBR 

IBTRANSIT 

SG2 

SG5 

IBTRANSIT 

AUTOCODER 

IBTRANSIT 

SGI 

CREATLIB 

IBTRANSIT 

SORTDEFINE 

IBTRANSIT 

DEFINE 



Bootstrap 

Resident Monitor, including IOCS 

Transitional Monitor 

Linkage Loader 

Relocatable Library 

Additional Copy 

System Generation Program, Part 2 

System Library Update 

Additional Copy 

Processor and Macro Library 

Additional Copy 

System Generation Program, Part 1 

Create Library 

Additional Copy 

Sort Definition 

Additional Copy 

File Organization System Definition 



Basic Resident Monitor 

The basic Resident Monitor on the Master file has the 
following design. 

System: 1410 System with 40,000 positions of core storage 

With: 1. Five-position console input area 

2. Console printing of all Monitor control cards 

3. Two channel, tape and unit-record IOCS 

4. Error statistics 

5. Variable Print routine 

6. Variable Punch routine 

7. POW 

Without: 1. Labeling 

2. Tele-processing 

3. Restart 

4. Core Image file ( MDM ) 

5. AIU routine 

6. User-written service routines 

7. Snapshot at unusual end of program 

Symbolic units requiring assignment are: 

MGO, MJB, MWl, MW2, MW3, and MRO. 

SPR and SPU require assignment only if Print and Punch are 
wanted. 

Control cards that could be used to generate a Mas- 
ter file are shown in Figure 18. 



16 



21 



MQN($ 
MON$$ 
MQN$$ 
MONt$ 
MQN($ 
MON$$ 
MQN$$ 
HON$$ 
MGN$$ 
MON$$ 
MON$$ 



MON$$ 



HON$$ 



MON$t 
MON$$ 



DATE YRDAY 

ASGN SPR.Al ^^^„ ^,, ^ 

JOB CREATE TAPE MASTER FILE 

ASGN MWl.Bl 

ASGN MW2,A2 

ASGN MW3,B3 

ASGN MJB,B3 

ASGN MG0,A6 

ASGN MR0.A6 

MODE GQ.SG 

EXEQ AUTOCODER,,, NQFLG.NOPCH 

PST 

HEADRTAPE MASTER FILE 

GEN01P1,R1,XI,P2,R2,X2 

GEN02,1,A0,AI,A2,A3,AA,A5,A6 

GENO2,2,B0.Bl,B2,B3,B4,B5,B6 

GEN08 1300009330,, 55, 5, 099, AO.Rl 

GEN091 

GEN104 

GENir 

DEVDFl, 7330, 1402,1403 

DEVDF2, 7330, 1402, 1403 

I0KDF1410,,,4 

END 

EXEQ SGI 

LOCATM, AUTOCODER 

INSERM 

LOCATC, CREATLIB 

INSERC 

LOCATR, IBMLIBR 

INSERR 

END 

CREATTMONITOR 

CREATTLINKLOAD 

PHASEIBMLIBR 

CREATTTRANSIT 

CREATTSYSGEN2 

CREATSG5TD 

CREATTTRANSIT 

CREATTAUTOCODE 

CREATTTRANSIT 

CREATTSYSGENl 

PHASECREATLIB 

CREATTTRANSIT 

CREATTSRTDEFIN 

CREATTTRANSIT 

CREATOEFINE 

CREATTTRANSIT 

END 

EXEQ LINKLOAD 

INPUTMW2 

EXEQ SG2 

END TAPE MASTER GENERATION 



Figure 18. Control Cards Used to Generate a Master File for 
a Tape-Oriented System 
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IBM Master File — Disk-Oriented System 



This section lists; (1) the assignment symbols and 
disk addresses that must be used by each user for 
his initial System Generation run, (2) the programs 
available on the Master file, and (3) the construction 
of the basic Resident Monitor. This section applies 
only to a disk-oriented system and need not be read 
by persons interested in a tape-oriented system. 

Assignment Symbols for Initial Run 

Arbitrary assignment symbols have been chosen for 
use in the Master file. Therefore, the first run made 
by each user must be made on the basis of these as- 
signment symbols. For the initial run, mon$s asgn 
cards must be prepared. These cards assign physical 
units to those duties specified under "Basic Concepts 
— Disk-Oriented System." 

The symbols available for assignment to the physi- 
cal units for the initial System Generation run are 
listed in Table 3. 



Programs Available 

The programs available on the Master file for a disk- 
oriented system are: 



IBSGDL 
IBBOOT 

LINKLOAD 

AUTOCODER 

SGI 

SG2 

SG5 

DSRTDEFINE 

UTILITIES 



DEFINE 
IBSGDL 

MACROLIB 
CREATLIB 
IBMLIBR 



System Generation Disk Load Program 
Bootstrap, Resident Monitor, and Transitional 
Monitor 
Linkage Loader 
Autocoder Language Processor 
System Generation Program, Part 1 
System Generation Program, Part 2 
System Library Update Program 
Disk Sort Definition Program 
Storage Print, Tape Print, Disk Print, 1301 
Format/ Address Generator, 2302 Format/ Ad- 
dress Generator, 1311 Format/ Address Gen- 
erator, File Save, File Restore, and Data File 
Generator programs 

File Organization System Definition Program 
Additional copy of System Generation Disk 
Load Program 
Macro Library 
Create Library 
Relocatable Library 



Table 3. Assignment Symbols and Addresses, Disk System 





Channel 1 


Channel 2 




Assignment 


Assignment 


Physical Unit 


Symbols 


Symbols 


Card Reader 


*R1 


R2 


Printer 


**P1 


**P2 


Punch 


**X1 


**X2 


Tape (729 or 7330) 


AO 


BO 




Al 


Bl 




A2 


B2 




A3 


B3 


Disk (see Note 1 ) 


*E1 


Gl 




E2 


G2 




E3 


G3 




E4 


G4 




E5 


G5 




E6 


G6 




E7 


G7 



Cylinders 



20 
40 
25 
20 
15 
15 
10 



AM 



Start 
Track 



End 
Track 



HR 



Note 



00 


0000 


0799 


00 


2,7 


00 


0800 


2399 


00 


3,7 


00 


2400 


3399 


00 


4 


00 


3400 


4199 


00 


5 


00 


4200 


4799 


00 


6 


00 


4800 


5399 


00 


6 


00 


5400 


5799 


00 


6 



* Rl is assigned on the SIU, but the unit assigned as SIU can be changed from the console. 
El is assigned on the SOF, but the unit assigned as SOF can be changed from the console. 
** The Standard Print and Punch variable routines are included but are not preassigned. They can be assigned to either unit-record or 

tape devices. 
NOTES: 

1. Disk must be formatted for 150 cylinders. Format is Load mode with the record address equal to the track address and an HA identi- 
fier of 00. Address format: AMTTTTHA, as explained under "Organization of Data Files on Disk Storage. " 

2. Assign area to Master file by means of console if channel 2 is used. 

3. Assign area E2 or G2 to Relocatable Library (LIB) by means of ASGN card. 

4. Assign area to Job file by means of ASGN card. 

5. Assign area to Go file by means of ASGN card. 

6. Assign Work files MWl, MW2, and MW3 by means of ASGN cards. 

7. When loading the operating section of the Master file onto disk, begin loading at module 0, track 0000. The Relocatable 
Library begins on module 0, track 0800. These areas correspond to El or Gl and E2 or G2. 
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Basic Resident Monitor Without: l. Labeling 

2. Tele-processing 
The basic Resident Monitor on the Master file has the 3. Restart 

following design. 4. Core Image file ( MDM ) 

^ * ,5. AIU routine 

System: 1410 Data Processing System with 60,000 positions q. User-written service routines 

of core storage 7, Snapshot at unusual end of program 

With: 1. Five-position console input area SymboUc units requiring assignment are: 

Console prmtmg of all Monitor control cards j^qO, MJB, MWl, MW2, and MW3. 

Two channel, tape, disk, and umt-record IOCS gpj^ ^^^ gp^ require assignment only if Print and Punch are 

Error statistics wanted 

Write disk check 

vSSle Punch Cttoe Control cards used to generate the Master file are 



POW shown in Figure 19. 



6 16 21 

••• INSERT BOOTSTRAP CARD ••• 
MON$$ DATE YRDAY 
MON$$ ASGN SPR.Al 

MaN$$ JOB CREATE DISK MASTER FILE 
MaN$$ ASGN LIB,E2 
MON$$ ASGN MJBfE3 
HaN$$ ASGN MG0,E4 
HON$$ ASGN MW1,E5 
MGN$$ ASGN MW2tE6 
MGN$« ASGN MW3.E3 
MON$$ MODE GO.SG 
MON$$ EXEQ AUTOCODER, ,,N0FLG,N01>CH 

HEAOR DISK MASTER FILE VER. 4 

GEN01P1,R1,X1,P2.R2,X2 

GEN02,1,A0,A1,A2,A3 

GEN02,2,BO.B1,82,B3 

GEN03E 1,00000000, 0799, E2, 00080000, 2399, £3,00240000,3399, 
E4, 003A0000, 41 99, £5, 00420000, 4799, E6, 00480000, 5399, 
£7,00540000,5799 

GEN04G1, 00000000,0799, 62,00080000, 2399, 03,00240000, 3399, 
04,00340000, 4 199, 05,00420000, 4799, 66,00480000, 5399, 
67,00540000,5799 

GEN08 1590009330,, 55, 5, 009, E1,R1 

GEN09 

GEN104 

GENU 

DEVDF 1,73 30, 1402, 1403 

DEVDF2, 7330, 1402,1403 

0SKDF1,0C 

DSK0F2,00 

I0KDF1410,,,4,,,,8 

END 
MGN«$ ASGN MW2,A2 
MGN$$ EXEQ SGI 9 

CREATDMONITOR 

CREATOLINKLOAD 

CREATOAUTOCODE 

CREATOSYSGENl 

CREATDSYSGEN2 

CREATSG5TD 

CREATDSRTDEFIN 

CREATUTILITIES 

CREATDEFINE 

CREATIBSGDL 

END 
MGN$$ EXEQ LINKLOAD 

INPUTMW2 
MGNSS EXEQ SG2 9 

LOCATM.MACROLIB 

INSERM 

LOCATCCREATLIB 

INSERC 

LOCATR,IBMLIBR 

INSERR 

END 
MQN$$ END 

Figure 19. Control Cards Used to Generate a Master File for a Disk-Oriented System 
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Contents of the Libraries 



This section lists the contents of the three libraries — 
Macro, Relocatable, and Create — as they are dis- 
tributed on the Master file. 

Macro Library Confenfs 

The following Macro Library is contained on both 
the tape- and disk-oriented Master files. On a tape- 
oriented Master, its name is autocoder. On a disk- 
oriented Master, its name is macrolib. 



SEQUENCE 


NAME 


SEQUENCE 


NAME 


1 


GET 


15 


GEN08 


2 


lOCTL 


16 


GEN09 


3 


UNCTL 


17 


GENIO 


4 


DTF 


18 


GENU 


5 


STDIO 


19 


DEVDF 


6 


MONOP 


20 


DSKDF 


7 


SYSIO 


21 


lOKDF 


8 


GENOl 


22 


GENRM 


9 


GEN02 


23 


DUMP 


10 


GEN03 


24 


ENDLD 


11 


GEN04 


25 


LDPTC 


12 


GEN05 


26 


TPDIR 


13 


GEN06 


27 


SPLDF 


14 


GEN07 







The user should refer to the section, "System Gen- 
eration Control Cards," before attempting to perform 
any maintenance function on this library. The Class ii 
control cards describe the operations that may be per- 
formed. 

It is also recommended that if the user is not going 

to use an sgf or sof for regeneration functions, he 

should delete the following macros from this library: 

GENOl GEN06 GENU 

GEN02 GEN07 DEVDF 

GEN03 GEN08 DSKDF 

GEN04 GEN09 lOKDF 

GEN05 GENIO GENRM 

SPLDF 

For information concerning the use of the above 
macros in generating a system, the reader should refer 
to the section, "System Description Control Cards." 

Relocatable Library Contents 

The following is a list of all the relocatable subpro- 
grams (modules) contained in the Relocatable Li- 
brary (ibmlibr) of both the tape- and disk-oriented 
Master files. The modules are listed below in the order 
in which they are sequenced in the Relocatable Li- 
brary. Refer to the section, "System Generation Con- 
trol Cards," for information concerning operations on 
this library. 



File Organization System Modules 

IBFOSCTLl 

IBFOSCTL2 

IBFOSLOADO 

IBFOSLOADl 

IBFOSLOAD2 

IBFOSADD 

IBF0SADD2 

IBFOSUNLOD 

IBFOSOOF 

IBFOSCOF 

IBFOSDG 

IBFOSSG 
File Organization System Definition Module 

IBFOSYSDEF 

Utility Program Module 

SNAPSHOT (If specified, generated as a part of the System 
Monitor or as part of a dependent program. ) 



Tape Sort Program Modules 

IBSRTCOMAN 

IBSRTPRIME 

IBSRTCTLCD 

IBSRTGASSR 

IBSRTGASM3 

IBSRTDUMOO 

IBSRTEQUAL 

IBSRTIOlOl 

IBSRTIO102 

IBSRTIO104 

IBSRTIO105 

IBSRTREPLT 

IBSRTREPLQ 

IBSRTIO103 

IBSRTIO106 

IBSRTPIASN 

IBSRTDUMOl 

IBSRTEQASN (Duplicate) 

IBSRTIO109 

IBSRTIOllO 

IBSRTIO107 

IBSRTIO108 

IBSRTIO203 

IBSRTIO201 

IBSRTMNTS2 

IBSRTMNTM2 

IBSRTRPPH2 

IBSRTIO205 

IBSRTIO206 

IBSRTDUM02 

IBSRTAMRG2 

IBSRTIO204 

IBSRTIO202 

IBSRTI0314 

IBSRTIO301 

IBSRTIO302 

IBSRTIO305 

IBSRTIO306 

IBSRTI0399 
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IBSRTMNTM3 

IBSRTMNTS3 

IBSRTRMRG3 

IBSRTLKAD3 

IBSRTIO303 

IBSRTIO304 

IBSRTSQTG3 

IBSRTDUM03 

IBSRTEQASN (Duplicate) 

IBSRTSUPH3 

IBSRTAMRG3 

IBSRTIO307 

IBSRTIO308 

IBSRTIO310 

IBSRTI0311 

IBSRTI0312 

IBSRTIO309 



Disk Sort Program Modules 

IBDSRTCOMN 

IBDSRTPTTP 

IBDSRTPRIM 

IBDSRTGAOl 

IBDSRTGA02 

IBDSRTGADM 

IBDSRTEQAL 

IBDSRTRPPl 

IBDSRTOCFl 

IBDSRTMCFl 

IBDSRTIOJl 

IBDSRTIOKl 

IBDSRTIOLl 

IBDSRTIOMl 

IBDSRTAP21 

IBDSRTDUMl 

IBDSRTEQAS 

IBDSRTAPll 

IBDSRTIOAl 

IBDSRTIOCl 

IBDSRTIOEl 

IBDSRTIOBl 

IBDSRTIODl 

IBDSRTIOEl 

IBDSRT0CF2 

IBDSRTMCF2 

IBDSRTRPP2 

IBDSRTAP12 

IBDSRTOCF3 

IBDSRTMCF3 

IBDSRTRP13 

IBDSRTRP23 

IBDSRTRP33 

IBDSRTRP43 

IBDSRTRP53 

IBDSRTRP63 

IBDSRTRP73 

IBDSRTRP83 

IBDSRTRP93 

IBDSRTIORl 

IBDSRTHS13 

IBDSRTDUM3 

IBDSRTAP13 

IBDSRTAP23 

IBDSRTAP33 

IBDSRTAP43 

IBDSRTAP53 



CHAIN Object-Time Modules 

CHAIN 
RETURN 



COBOL Object-Time Modules 



IBCOBOL 

IBCBLADOVR 

IBCBLDSPLY 

IBCBLCMPAR 

IBCBLFLDMP 

IBCBLALTST 

IBCBLSUBSG 

IBCBLACCPT 

IBCBLEXPON 

IBCBLRDINT 

IBCBLDVZER 

IBCBLCLEAR 



FORTRAN Object-Time Modules 

IBINTRP (Programmed interpretations, floating-point) 

OVERFL^ 

DVCHK y (Machine interpretations, floating-point) 

IBINTRP J 

IBCOMMON 

IBLABEL 

IBFOERR 

IBINDXl 

IBINDX2 

IBINDX3 

IBEXPFl 

IBEXPFF 

ALOG 

EXP 

EXIT 

AMAXO 

AMINO 

FLOAT 

MAXl 

MINI 

INT 

IFIX 

IBEXPII 

IBBACKSP 

IBREWIND 

IBENDFILE 

SQRT 

ABS 

lABS 

AMAXl 

MAXO 

AMINl 

MINO 

COS 

SIN 

AMOD 

AINT 

SIGN 

ISIGN 

MOD 

DIM 

IDIM 

ATAN 

SLITE 

SLITET 



Random-Processing Scheduler Modules 



IBRANDOM 

IBRANDOMl 

IBRAND0M2 

IBRANDOM3 

IBRANDOM4 

IBRAND0M5 

IBRANDOM6 



( Should be generated and placed here ) 



Contents of the Libraries 53 



Miscellaneous 
IBLOOKM 

1311 IOCS Modules 

IBCYLOFLO 
IBSCAN1311 

Resident Monitor Modules 

IBMVERSION 

IBZRRTP 

IBBSPTP 

IBSIMTP 

IBABtPM 

IBABDKM 

IBRDSIU 

IBPRTUR 

IBPRTTP 

IBPRTVAR 

IBPRTNONE 

IBPCHUR 

IBPGHTP 

IBPCHVAR 

IBPCHNONE 

IBPPCOMMON 

IBREADAIU 

IBIOARM 

IBAINQUIRY 

IBZRRDK 

IBSIMDK 

Tele-processing Supervisor Modules 

TPPTCCHl 

TPPTCCH2 

TPSTARTCHl 

TP1050CH10 

TP1050CH11 

TP7770CH1 

TP1009CH1 

TP1014CH10 

TP1014CH11 

TPTELCHIO 

TPTELCHll 

TPTELCH12 

TPENDCHl 

TPSTARTCH2 

TP1050CH20 

TP1050CH21 

TP7770CH2 

TP1009CH2 

TP1014CH20 

TP1014CH21 

TPTELCH20 

TPTELCH21 

TPTELCH22 

TPENDCH2 

TPSUPER 

TPSUPERDR 

TPSUPERTPO 

TPSUPERDDR 

TPBASSUPER 

TPTAPEDUMP 

TPDISKDUMP 

TPONLY 

tPTA^ELDRA 

TPTAPELDRR 

TPDISKLDRA 

TPDISKLDRR 

TPLDBRPROC 

TPLDRDEP 



Transitional Monitor Modtdes 

IBREADMOCC 

IBSCANM 

IBEXEQM 

IBIOATM 

IBIOATMVAR 

IBSEARCHT 

IBACCOUNT 

IBPOWTRAN 

IBSEARCHD 

IBSPLNITER 

Sort Definition Program Module 

IBSRTDEFIN 
IBDSRTDEF 

Linkage Loader Modules 

IBLNKPROC 

IBLNKGOTAP 

IBLNKINTAP 

IBLNKOUTAP 

IBLNKGODSK 

IBLNKINDSK 

IBLNKOUDSK 

IBCOUPLE 

Miscellaneous 

IBUPPER 

Autocoder Compiler Modules 

IBAUIOCOMM 

IBAUIOINPT 

IBAUIOTPEI 

IBAU10TPE2 

IBAUIOIOTB 

IBAU20GENR 

IBAU20TPE1 

IBAU20TPE2 

IBAU30ASGN 

IBAU30SCAN 

IBAU30TPE1 

IBAU30SUBR 

IBAU33SUBR 

IBAU33TPE1 

IBAU33RCUR 

IBAU40OTPT 

Go Modules for Compilers 

IBTOCGM 
IBTPGGM 
IBTCCGM 
IBTNCGM 
IBDOCGM 
IBDPCGM 
IBDCCGM 
IBDNCGM 

Autocoder Compiler Modules (continued) 

IBAU40TPE1 
IBAU50TPE1 
IBAU50CREF 
IBAUIODSKI 
IBAU10DSK2 
IBAU10DSK3 
IBAU20DSK1 
IBAU20DSK2 
IBAU20DSK3 
IBAU30DSK1 
IBAU33DSK1 
IBAU40DSK1 
IBAU50DSK1 
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COBOL Compiler Modules 



System Generator Modules 



IBCBLCSPOl 

IBCBLCSP09 

IBCBLCSP02 

IBCBLCSP03 

IBCBLPOMFl 

IBCBLCST04 

IBCBLCST05 

IBCBLPIMFI 

IBCBLP1MF2 

IBCBLCST06 

IBCBLP1MF3 

IBCBLCST07 

IBCBLP2MF1 

IBCBLCSP08 

IBCBLP2MF2 

IBCBLP2MF3 

IBCBLP2MF4 

IBCBLP3MF1 

IBCBLP3T01 

IBCBLP4MF1 

IBCBLP5MF1 

IBCBLCSD04 

IBCBLCSD05 

IBCBLCSD06 

IBCBLCSD07 

IBCBLP3D01 



FORTRAN Compiler Modules 



IBFTNCMN 

IBFTN05TO 

IBFTN05 

IBFTNIOTO 

IBFTNIOTI 

IBFTNIO 

IBFTN20TO 

IBFTN20TI 

IBFTN20 

IBFTN25TI 

IBFTN25 

IBFTN05DO 

IBFTNIODO 

IBFTNIODI 

IBFTN20DO 

IBFTN20DI 

IBFTN25DI 



Utility Program Modules 



IBUTILITY 

IBUTILSCAN 

IBTAPEDUMP 

IBDISKDUMP 

IBCORICDCTL 

IBCOREDUMP 

IBOIFAGEN 

IBllADRGEN 

IB1311LBL1 

IB1311LBL2 

IBADDRESR 

IBFILESAVE 

IBFILEREST 

IB02FAGEN 

IBFILEGEN 



Loader Modules for PTC Programs 



TPLDDCPl 
TPLDDCP2 



IBSYSGENl 

IBSYSGEN2 

IBDSYSGENl 

IBDSYSGEN2 

IBDSYSGEN3 

IBSGLDLDR 

Tape-to-Disk SOF Load Modules 

SGDLBOOT 

IBDLIO 

IBDLIOA 

IBDLIOB 

IBDLIOC 

IBDLIOD 

IBSGDLDR 

SG4 and SG5 Program Modules 

IBSG4 

IBSG5 

IBSG5D 

IBSG5T 

IBSG5E 

Macro Print and Punch Modules 

IBPRINTMT 
IBPRINTMD 
IBPRINTM 

TP Library Generator Modules 

TPATLIBGEN 
TPADLIBGEN 
TPLIBGENXT 
TPLIBGENXD 
TPLIBGENXP 



Create Library Contents 

The following Create Library is contained on both the 
tape- and disk-oriented Master files. Additional Create 
packets are documented in the following section of 
tables, but they are not provided as part of the Create 
Library. The name of the library is creatlib. 

A "T" or "D" prefix on the name of a Create packet 
refers to an exclusively tape-oriented or disk-oriented 
packet. Where there is no prefix, the same package 
applies for both tape and disk. 

TMONITOR 

Includes IBBOOT, IBRESMON, and IBTRANSIT for tape 

system. 

( No provision made for Tele-processing Supervisor. ) 

RESTART 

The CREATRESTART card, if used, must immediately fol- 
low the CREATTMONITOR or CREATDMONITOR card. 

TSRTDEFIN 

TLINKLOAD 

SYSGEN3 

TAUTOCODE 

TCOBOL 

TFORTRAN 

UTILITIES 

Includes Storage Print, Tape Print, Disk Print (1301, 2302, 
1311), 1301 Format/Address Generator, 2302 Format/Ad- 
dress Generator, 1311 Format/Address Generator, File Save 
(1301/2302), File Restore (1301/2302), and Data File 
Generator (Tape, 1301, 2302) Utility Programs. 



Contents of the Libraries 55 



TSYSGENl 
TSYSGEN2 
TMACROPRT 
DMONITOR 

Includes IBSGDL and IBBOOT for a disk system. (Resident 

and Transitional Monitor are part of IBBOOT. No provision 

made for Tele-processing Supervisor. ) 
DLINKLOAD 
DAUTOCODE 
DCOBOL 
DFORTRAN 
DSYSGENl 
DSYSGEN2 
DMACROPRT 
DSKLIBLDR 

To place a Relocatable Library on disk. 
TSYSTEM 
DSYSTEM 
LINKLOADTD 
LINKLOADDT 
TMONTPl 



TM0NTP2 

DMONTPl 

DM0NTP2 

IBSGDL 

TTRANSIT 

LINKLOADRD 

LINKLOADRT 

TCLINKLOAD 

DCLINKLOAD 

DSRTDEFIN 

LABEL1311 

SG4TD 

SG5TD 

DEFINE 

Note: The Linkage Loader expects that the first 
eight characters of the phase name will be "linkload." 
Any two characters may follow, making the format 
"linkloadxx." If this format is not followed, the Link- 
age Loader will not build any symbol tables. 
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Creation Charts 



The following charts show 1:he Linkage Loader con- 
trol cards that can be used to construct the ibm pro- 
grams available within the system. 

These charts show some of the permissible con- 
figurations of the programs. They also indicate those 
configurations that will be constructed by specific 
Create packets. 

Note: Many of the modules contain imbedded 
calls. Because of this, a specific program may require 
modules not listed on the creation charts. 



Use of Creation Charts 

The following example illustrates the use of these 
charts. Refer to the Linkage Loader chart, which 
shows that a total of eight possible configurations of 



the Linkage Loader can be generated. The Go file, 
the SOF (or sgf, during System Generation) and the 
library can each be on either tape or disk, giving a 
total of eight combinations. The user makes his selec- 
tion from the possibilities given at the top of the table. 
For example, if all files are to be on tape, the first 
column is the appropriate one. The user then has the 
choice of calling Create packet tunkload or punching 
the appropriate cards as indicated at the lower por- 
tion of the table. 

Where a Create packet name is given for a selected 
configuration, the lower half of the table shows the 
exact contents of this package. If there is no name 
entered and if the appropriate configuration is desired, 
the user must supply the cards indicated (in the order 
shown ) . 



LINKAGE LOADER 






Go File on 




X 


X 


X 


X 














Disk 
Taoe 


X 


X 






X 
X 


X 
X 


X 


X 






SOF on 
LIB on 


Disk 
Tape 


X 




X 
X 


X 


X 




X 
X 


X 






Disk 




X 




X 




X 




X 






Create Packe 


t Name 


TLINKLOAD 














DLINKLOAD 


TCLINKLOAD 


DCLINKLOAD 


16 


21 






















PHASE 


LINKLOAD 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 
X 


CALL 


IBLNKPROC 


X 


X 


X 


X 


X 


X 


X 


X 


X 


CALL 


IBLNKGOTAP 


X 


X 


X 


X 










X 


X 


CALL 


IBLNKGODSK 










X 


X 


X 


X 




CALL 


IBLNKINTAP 


X 




X 




X 




X 








CALL 


IBLNKINDSK 




X 




X 




X 




X 




X 


CALLN 


IBLNKOUTAP 


X 


X 






X 


X 






X 


X 


CALLN 


IBLNKOUDSK 






X 


X 






X 


X 




CALL 


IBCOUPLE 




1 1 










X 



NOTE: Create pockets TCLINKLOAD and DCLINKLOAD ore for chained programs. 
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Monitor Modules in Relocatable Library 

REQUIRED 

IBACCOUNT 

IBAINQUIRY 

IBEXEQM 

IBIOARM 

IBPPCOMMON 

IBRDSIU 

IBREADMOCC 

IBSCANM 

IBMVERSION 



required: tape only 
IBBSPTP 
IBSEARCHT 
IBSIMTP 
IBTGCGM 
IBTNCGM 
IBTOCGM 
IBTPGGM 
IBZRRTP 
IBABTPM 



required: disk only 
IBDCCGM 
IBDNCGM 
IBDOCGM 
IBDPCGM 
IBSEARGHD 
IBSIMDK 
IBZRRDK 
IBABDKM 



CONDITIONAL 

IBIOATM (Transitional Monitor Input/Output Assign- 
ment) 

IBIOATMVAR (Transitional Monitor Input/Output Assign- 
ment Variable ) 

IBPGHNONE ( No Standard Punch Unit ) 

IBPCHTP (SPUistape) 

IBPGHUR ( SPU is 1402 Gard Read Punch ) 

IBPGHVAR ( Variable Punch ) 

IBPRTNONE ( No Standard Print Unit ) 

IBPRTTP (SPRistape) 

IBPRTUR ( SPR is 1403 Printer ) 

IBPRTVAR ( Variable Print ) 

IBLOOKM ( Required by Utility programs ) 

IBREADAIU ( System includes Alternate Input Unit ) 

IBPOWTRAN ( POW required for tape SPR and/or SPU ) 

SNAPSHOT ( Required for Snapshot capability ) 

IBSPLNITER ( Required for SPOOL capability ) 



SYSTEM MONITOR 


SOFon 


Tape 


X 






Disk 




X 




Create Packet Name 


TMONITOR 


DMONITOR 


TTRANSIT 


16 21 
PHASE IBSGDL 
CALL SGDLBOOT 




X 
X 




PHASE 
** CALL IBDLIO 

CALLN IBSGDLDR 




X 
X 
X 




PHASE IBBOOT 
CALL IBBOOTIT 
CALL IBBOOT2D 


X 
X 


X 
X 




PHASE 
* CALL IBBOOT2T 


X 
X 


X 




PHASE IBRESMON 
PRTCT 00000 
CALLN IBRESIOCS 
CALLN IBRESIDENT 
CALLN IBMENDM 


X 
X 
X 
X 
X 


X 
X 
X 
X 




PHASE 

PHASE IBTRANSIT 

CALLN IBTRANSIT 


X 
X 


X 
X 


X 


61 
PHASE 1 
DISGO 
PRTCT 


X 
X 
X 


X 
X 
X 


X 



Thete modules ore produced by 

the Syttem Generation macros. 

This module is contained in the Relocatable Library. 

To insert Directory 1 . 



RESTART PROGRAM * 


Create Packet Name 


RESTART 




16 21 






CONGO 


X 




PRTCT 00000 


X 




PHASE RESTART 


X 


** 


CALL IBRSTMOD1 


X 




PHASE 


X 


** 


CALL IBRSTMOD2 


X 




PHASE 


X 


** 


CALLN IBRSTMOD3 


X 




DISGO 


X 




PRTCT 


X 



If used, the CREATRESTART card must immediately follow 
the CREATTMONITOR or CREATDMONITOR card. 
This module is generated with the Resident IOCS. 
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MONITOR 
(For Tele-Processing System) 


SOF On 


Tape 


X 


X 






Disk 






X 


X 


Create Packet Nome 


TMONTPl 


TMONTP2 


DMONTPl 


DMONTP2 


16 21 

PHASE IBSGDL 

CALL SGDLBOOT 

PHASE 

CALL IBDLIO 

CALLN IBSGDLDR 






X 
X 
X 
X 
X 




PHASE IBBOOT 
CALL IBBOOTIT 
CALL IBBOOT2D 


X 
X 




X 
X 




PHASE 

CALL IBBOOT2T 


X 
X 




X 




PHASE IBRESMON 
PRTCT 00000 
CALLN IBRESIOCS 
CALLN IBRESIDENT 
CALLN IBRESIDEN2 
CALLN IBMENDM 


X 
X 
X 


X 
X 
X 


X 
X 


X 
X 
X 


PHASE 

PHASE IBTRANSIT 

CALLN IBTRANSIT 




X 
X 




X 
X 


61 
PHASE 1 
DISGO 
PRTCT 




X 
X 
X 




X 
X 
X 



AUXILIARY LINKAGE LOADERS* 




DISK TP LIBRARY 


TAPE TP DISK 1 


SOF on Tope 


X 




X 




X 




SOF on Disk 




X 




X 




X 


Relocatable Library or»d 














Go File on Tape 


X 




X 




X 




Relocatable Library and 














Go File on Disk 




X 




X 




X 


Output on Tape 








X 


X 


X 


Output on Disk 


X 


X 


X 








Create Packet Name 


LINKLOADTD 


LINKLOADRD 




LINKLOADDT 


LINKLOADRT 




16 21 














PHASE LINKLOADTD 


X 












PHASE LINKLOADDT 








X 






PHASE LINKLOADRT 










X 


X 


PHASE LINKLOADRD 




X 


X 








CALL IBLNKPROC 


X 


X 


X 


X 


X 


X 


CALL IBLNKGOTAP 


X 




X 




X 




CALL IBLNKGODSK 




X 




X 




X 


CALL IBLNKINTAP 


X 




X 




X 




CALL IBLNKINDSK 




X 




X 




X 


CALLN IBLNKOUTAP 








X 






CALLN IBLNKOUDSK 


X 












CALLN TPLIBGENXT 










X 


X 


CALLN TPLIBGENXD 




X 


X 









*LINKLOADTD and LINKLOADDT are for use in Tele-processing systems that store the TP Library file in a storage medium different 
from that used for the SOF and Job file (disk TP library in a tape-oriented system, or tape TP library in a disk-oriented system). The 
remaining four configurations ore the one-pass TP Relocatable Library generators. 
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COBOL 


Go File on 


Tape 


X 


X 






Disk 






X 


X 


Work Files on 


Tope 


X 




X 




Disk 




X 




X 


Create Packet Name 


TCOBOL 






DCOBOL 


6 16 21 

001 PHASE COBOL 

CALL IBTNCGM 
CALL IBDNCGM 
CALLN IBCBLCSPOl 
CALL IBCBLCSP09 
CALLN IBCBLCSP02 
CALL IBCBLCSP03 
CALLN IBTOCGM 
CALLN IBDOCGM 
CALL IBCBLP0MF1 


X 
X 

X 
X 
X 
X 
X 

X 


X 
X 

X 
X 
X 
X 
X 

X 


X 

X 
X 
X 
X 
X 

X 
X 


X 

X 
X 
X 
X 
X 

X 
X 


010 PHASE 

BASEl IBTOCGM 
BASEl IBDOCGM 
CALL IBTPCGM 
CALL IBDPCGM 
CALLN IBCBLCST04 
CALLN IBCBLCSD04 
CALL IBCBLCST05 
CALL IBCBLCSD05 
CALLN IBCBLP1MF1 


X 
X 

X 

X 

X 

X 


X 
X 

X 

X 

X 
X 


X 

X 

X 
X 

X 

X 


X 

X 

X 

X 

X 
X 


015 PHASE 

PRTCT IBCBLP1MF1 
BASEl IBCBLP1MF1 
CALL IBCBLP1MF2 


X 
X 
X 
X 


X 
X 
X 
X 


X 
X 
X 
X 


X 
X 
X 
X 


020 PHASE 

BASEl IBCBLP1MF2 
CALL IBCBLCST06 
CALL IBCBLCSD06 
CALLN IBCBLP1MF3 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 
X 

X 


X 

X 
X 


025 PHASE 
PRTCT 

BASEl IBCBLCST04 
BASEl IBCBLCSD04 
CALL IBCBLCST07 
CALL IBCBLCSD07 
CALLN IBCBLP2MF1 


X 
X 
X 

X 

X 


X 
X 

X 

X 
X 


X 
X 
X 

X 

X 


X 
X 

X 

X 
X 


030 PHASE 

BASEl IBCBLCSP02 
CALL IBCBLCST04 
CALL IBCBLCSD04 
CALLN IBCBLCST06 
CALLN IBCBLCSD06 
CALL IBCBLCST07 
CALL IBCBLCSD07 
CALLN IBCBLCSP08 


X 
X 
X 

X 

X 

X 


X 
X 

X 

X 

X 
X 


X 
X 
X 

X 

X 

X 


X 
X 

X 

X 

X 
X 


035 PHASE 

CALL IBCBLP2MF2 


X 
X 


X 
X 


X 
X 


X 
X 


040 PHASE 

BASEl IBCBLP2MF2 
CALL IBCBLP2MF3 


X 
X 
X 


X 
X 
X 


X 
X 
X 


X 
X 
X 


045 PHASE 

BASEl IBCBLP2MF3 
CALL IBCBLP2MF4 


X 
X 
X 


X 
X 
X 


X 
X 
X 


X 
X 
X 


050 PHASE 

BASEl OLEE/ 
CALL IBTPCGM 
CALL IBDPCGM 
CALLN IBCBLP3MF1 
CALL IBCBLP3T01 
CALL IBCBLP3D01 


X 
X 
X 

X 
X 


X 
X 
X 

X 

X 


X 
X 

X 
X 
X 


X 
X 

X 
X 

X 


055 PHASE 

BASEl IBCBLP3MF1 
CALL IBCBLCSP03 
CALLN IBCBLCST07 
CALLN IBCBLCSD07 
CALL IBCBLCSP08 
CALLN IBTCCGM 
CALLN IBDCCGM 
CALL IBCBLP4MF1 


X 
X 
X 
X 

X 
X 

X 


X 
X 
X 

X 
X 
X 

X 


X 
X 
X 
X 

X 

X 
X 


X 
X 
X 

X 
X 

X 
X 


060 PHASE 

CALL IBCBLP5MF1 


X 
X 


X 
X 


X 
X 


X 
X 



60 



AUTOCODER 


Work Files and 
Go Files on 


Tope 


X 


X 






Disk 






X 


X 


Processor 
Resides on 


Tape 


X 




X 




Disk 




X 




X 


Create Packet Name 


TAUTOCODE 






DAUTOCODE 


6 16 21 

001 PHASE AUTOCODER 
CALL IBAU10COMM 
CALLN IBAU10INPT 
CALL IBAU10TPE1 
CALL IBAU10TPE2 
CALL IBAU10DSK1 
CALL IBAU10DSK2 
CALL IBAU10DSK3 
CALL IBAU10IOTB 


X 
X 
X 
X 
X 

X 


X 
X 
X 
X 

X 
X 


X 
X 
X 

X 

X 
X 


X 
X 
X 

X 
X 

X 


61 
* 010 PHASE 3 

62 
** 015 PHASE M 


X 
X 


X 


X 
X 


X 


020 PHASE 

CALLN IBAU20GENR 
CALL IBAU20TPE1 
CALL IBAU20TPE2 
CALL IBAU20DSK1 
CALL IBAU20DSK2 
CALL !BAU20DSK3 


X 
X 
X 
X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


030 PHASE 

CALLN IBAU30ASGN 
CALL IBAU30SCAN 
CALL IBAU30TPE1 
CALL IBAU30DSK1 
CALLN IBAU30SUBR 


X 
X 
X 
X 

X 


X 
X 
X 
X 

X 


X 
X 
X 

X 
X 


X 
X 
X 

X 
X 


033 PHASE 

CALLN iBAU33SUBR 
CALL IBAU33TPE1 
CALL IBAU33DSK1 
CALLN IBAU33RCUR 


X 
X 
X 

X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


040 PHASE 

CALLN IBAU40OTPT 
CALL IBTOCGM 
CALL IBDOCGM 
CALL IBTPCGM 
CALL IBDPCGM 
CALL IBTCCGM 
CALL IBDCCGM 
CALL IBTNCGM 
CALL IBDNCGM 
CALLN IBAU40TPE1 
CALLN IBAU40DSK1 


X 
X 
X 

X 

X 

X 

X 


X 
X 
X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


050 PHASE 

CALL IBAU50TPE1 
CALL IBAU50DSK1 
CALLN IBAU50CREF 


X 
X 

X 


X 
X 

X 


X 

X 
X 


X 

X 
X 



To insert Directory 3 

To insert the Macro Library 



COBOL: Relocatable Library Modules for Object 
Programs 

The following modules are required by cobol object 
programs: 

IBGOBOL 

IBCBLADOVR 

IBCBLDSPLY 



IBCBLCMPAR 

IBCBLFLDMP 

IBCBLALTST 

IBCBLSUBSC 

IBCBLACCPT 

IBCBLEXPON 

IBCBLRDINT 

IBCBLDVZER 

IBCBLCLEAR 
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FORTRAN: Relocatable Library Modules for Object 
Programs 

Required Modules 

The following modules are required to run with any 
FORTRAN object program: 



IBCOMMON 


IBINDX2 


IBBACKSP 


EXP 


IBLABEL 


IBINDX3 


IBENDFILE 


ALOG 


IBFOERR 


IBEXPFF 


IBREWIND 




IBINTRP 


IBEXPFI 


FLOAT 




IBINDXl 


IBEXPII 


IFIX 





Optional Modules 

The following modules are not required by a Fortran 
program unless they are called by name in the source 
program. Inclusion of these modules is therefore an 
installation option, except (as noted) the selection 
of one optional module may require another. 



ABS 




DIM 


AINT 




DVCHK 


AMAXO 




EXIT 


AMAXl 




lABS 


AMINO 




IDIM 


AMINl 




INT 


AMOD (requires AINT) 


ISIGN 


ATAN 




MAXO 


COS (requires 


SIN) 


MAXl 



MINO 

MINI 

MOD 

OVERFL 

SIGN 



SIN 

SLITE (requires SLITET) 

SLITET 

SQRT 



Floating-Point Arithmetic Modules 

The four modules supporting floating-point arithmetic 
are on the Relocatable Library of the Master file in 
the following order: 

POSITION NAME REMAKES 

1 IBINTRP For programmed interpretation of 

floating-point instructions. 

2 OVERFL "^ For machine interpretation of 

3 DVCHK V floating-point instructions ( on an 

4 IBINTRP J IBM 7010 with the Floating-Point 

Arithmetic feature ) . 

To obtain the modules supporting the 7010 Float- 
ing-Point Arithmetic feature, the following card should 
be used: 

6 16 21 

IBINTRP DELET R 

To obtain the modules that provide programmed 
interpretation for floating-point instructions, use this 
card: 

6 16 21 

OVERFL DELET R,IBINTRP 



FORTRAN 


Work Files on 


Tape 


X 


X 






Disk 






X 


X 


Go File on 


Tape 


X 




X 




Disk 




X 




X 


Create Packet Name 


TFORTRAN 






DFORTRAN 


16 21 










PHASE FORTRAN 


X 


X 


X 


X 


CALLN IBFTNCMN 


X 


X 


X 


X 


CALL IBFTN05TO 


X 


X 






CALL IBFTN05DO 






X 


X 


CALLN IBFTN05 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 FCMN/ 


X 


X 


X 


X 


CALL IBTPCGM 


X 




X 




CALL IBDPCGM 




X 




X 


CALL IBTCCGM 


X 




X 




CALL IBDCCGM 




X 




X 


CALL IBTNCGM 


X 




X 




CALL IBDNCGM 




X 




X 


CALLN IBTOCGM 


X 




X 




CALLN IBDOCGM 




X 




X 


CALL IBFTN10TO 


X 


X 






CALL IBFTN10DO 






X 


X 


CALL IBFTN10TI 


X 


X 






CALL IBFTN10DI 






X 


X 


CALLN IBFTN10 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 MOCG/ 


X 


X 


X 


X 


CALL IBFTN20TO 


X 


X 






CALL IBFTN200O 






X 


X 


CALL IBFTN20TI 


X 


X 






CALL IBFTN20DI 






X 


X 


CALLN IBFTN20 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 MOCG/ 


X 


X 


X 


X 


CALL IBFTN25TI 


X 


X 






CALL IBFTN25DI 






X 


X 


CALLN IBFTN25 


X 


X 


X 


X 
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Generalized Tape Sorting Program: Relocatable 
Library Modules 

To create any tape sort program, all of the following 
modules must appear in a Relocatable Library and 
should be in the order given. Module ibsrteqasn must 
be included twice, as shown. 



IBSRTCOMAN 

IBSRTPRIME 

IBSRTCTLCD 

IBSRTGASSR 

IBSRTGASM3 

IBSRTDUMOO 

IBSRTEQUAL 

IBSRTIOlOl 

IBSRTIO102 

IBSRTIO104 

IBSRTIO105 

IBSRTREPLT 

IBSRTREPLQ 

IBSRTIO103 

IBSRTIO106 

IBSRTPIASN 

IBSRTDUMOl 

IBSRTEQASN 

IBSRTIO109 

IBSRTIOllO 

IBSRTIO107 

IBSRTIO108 

IBSRTIO203 

IBSRTIO201 

IBSRTMNTS2 

IBSRTMNTM2 

IBSRTRPPH2 

IBSRTIO205 



IBSRTIO206 

IBSRTDUM02 

IBSRTAMRG2 

IBSRTIO204 

IBSRTIO202 

IBSRTI0314 

IBSRTIO301 

IBSRTIO302 

IBSRTIO305 

IBSRTIO306 

IBSRTI0399 

IBSRTMNTM3 

IBSRTMNTS3 

IBSRTRMRG3 

IBSRTLKAD3 

IBSRTIO303 

IBSRTIO304 

IBSRTSQTG3 

IBSRTDUM03 

IBSRTEQASN 

IBSRTSUPH3 

IBSRTAMRG3 

IBSRTIO307 

IBSRTIO308 

IBSRTIO310 

IBSRTI0311 

IBSRTI0312 

IBSRTIO309 



TAPE SORT DEFINITION PROGRAM 


Create Packet Name 


TSRTDEFIN 


16 21 

PHASE SORTDEFINE 

CALL IBSRTDEFIN 


X 
X 



Generalized Sorting Program Using IBM 1301/2302 
Disk Storage: Relocatable Library Modules 

To create any disk sort program, all of the following 
modules must appear in a Relocatable Library and 
should be in the order given. 



IBDSRTCOMN 

IBDSRTPTTP 

IBDSRTPRIM 

IBDSRTGAOl 

IBDSRTGA02 

IBDSRTGADM 

IBDSRTEQAL 

IBDSRTRPPl 

IBDSRTOGFl 

IBDSRTMCFl 

IBDSRTIOJl 

IBDSRTIOKl 

IBDSRTIOLl 

IBDSRTIOMl 

IBDSRTAP21 

IBDSRTDUMl 

IBDSRTEQAS 

IBDSRTAPll 

IBDSRTIOAl 

IBDSRTIOCl 

IBDSRTIOEl 

IBDSRTIOBl 

IBDSRTIODl 

IBDSRTIOFl 



IBDSRT0CF2 

IBDSRTMCF2 

IBDSRTRPP2 

IBDSRTAP12 

IBDSRTOCF3 

IBDSRTMCF3 

IBDSRTRP13 

IBDSRTRP23 

IBDSRTRP33 

IBDSRTRP43 

IBDSRTRP53 

IBDSRTRP63 

IBDSRTRP73 

IBDSRTRP83 

IBDSRTRP93 

IBDSRTIORl 

IBDSRTHS13 

IBDSRTDUM3 

IBDSRTAP13 

IBDSRTAP23 

IBDSRTAP33 

IBDSRTAP43 

IBDSRTAP53 



DISK SORT DEFINITION PROGRAM 


Create Packet Name 


DSRTDEFIN 


16 21 

PHASE DSRTDEFINE 

CALLN IBDiSRTDEF 


X 
X 



UTILITY PROGRAMS* 


Storage Print 


X 


X 


X 


X 


X 






Tape Print 




X 


X 




X 


X 




Disk Print (1301, 2302, 1311) 


X 


X 


X 


X 




X 


X 


1301 Disk Format/Address Generator 






X 


X 






X 


2302 Disk Foimat/Address Generator 






X 


X 






X 


1311 Format/Address Generator 


X 


X 


X 










File Save 






X 


X 






X 


File Restore 






X 


X 






X 


Data File Generator 






X 


X 








Create Packet Name 






UTILITIES 










001 PHASE UTILITIES 
CALLN IBLOOKM 
CALL IBUTILITY 

002 PHASE 

CALL IBUTILSCAN 

003 PHASE 

CALL IBTAPEDUMP 

004 PHASE 

CALL IBDISKDUMP 

005 PHASE 

CALLN IBCOREDCTL 
CALL (BCOREDUMP 

006 PHASE 

CALLN IBOIFAGEN 
CALL IBADDRESR 

007 PHASE 

CALL IBUADRGEN 

008 PHASE 

CALL IBFILESAVE 

009 PHASE 

CALL IBFILEREST 

010 PHASE 

CALLN IB02FAGEN 
CALL IBADDRESR 
016 PHASE 

- CALL IBFILEGEN 


X 
X 
X 
X 
X 

X 
X 
X 
X 
X 

X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 

X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 


X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 
X- 


X 
X 
X 
X 
X 
X 
X 

X 
X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 


X 
X 
X 
X 
X 

X 
X 

X 
X 
X 

X 
X 
X 
X 
X 
X 
X 



*The Snapshot Program, if selected, is generated as part of the System Monitor or part of a dependent program . 
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SGI PROGRAM 


SGFor 
SOF on 


Tape 


X 




Disk 




X 


Create Packet Name 


TSYSGENl 


DSYSGENl 


16 21 
PHASE SGI 
CALL IBSYSGENl 
CALL IBDSYSGENl 

61 
PHASE 1 


X 
X 

X 


X 
X 



* To insert Directory 1 . 



SG2 PROGRAM 


SGFor 
SOF on 


Tape 


X 




Disk 




X 


Create Packet Name 


TSYSGEN2 


DSYSGEN2 


16 21 

PHASE SG2 

CALL IBSYSGEN2 

CALL iBDSYSGEN2 

PHASE 

CALL IBDSYSGEN3 


X 
X 


X 

X 
X 
X 



SG3 PROGRAM 


Create Packet Name 


SYSGEN3 


16 21 
PHASE SG3 
CALL IBUPPER 


X 
X 



MACRO PRINT and PUNCH PROGRAM 


Macro Library on 


Tope 


X 




Disk 




X 


Create Packet Name 


TMACROPRT 


DMACROPRT 


16 21 

PHASE MACROPRT 

* CALL IBPRINTMT 

* CALL IBPRINTMD 


X 
X 


X 
X 



^Contains on imbedded call for module IBPRINTM. 



DISK LIBRARY LOADER 


Create Pocket Nome 


DSKLIBLDR 


16 21 

PHASE DSKLIBLDR 

CALL IBSGLDLDR 


X 
X 



1311 LABEL PROGRAM 


Create Packet Name 


LABEL1311 


16 21 

PHASE LABEL1311 

CALL IB1311LBL1 


X 
X 



SYSTEM DEFINITION PROGRAM (FILE ORGANIZATION SYSTEM) 


Create Packet Name 


DEFINE 


16 21 
PHASE DEFINE 
CALL IBFOSYSDEF 


X 
X 



MASTER TAPE LOAD PROGRAM* 



Create Packet Name 



16 


21 


PHASE 


IBSGDL 


CALL 


SGDLBOOT 


PHASE 




CALL 


IBDLIO 


CALLN 


IBSGDLDR 



*lf a disk SOF (or SGF) is to have regenerative ability, 
this program must be the last program on the file. 



SG4 PROGRAM 


Create Packet Name 


SG4TD 


16 21 
PHASE SG4 
CALL IBSG4 


X 
X 



IBSGDL 



COMPLETE SYSTEMS 


SOF Is on 


Tape 


X 




Disk 




X 




Create Packet Nome 


TSYSTEM 


DSYSTEM 




TMONITOR 


X 






DMONITOR 




X 




TCLINKLOAD 


X 






DCLINKLOAD 62 




X 




PHASE IBMLIBR R 


X 






TTRANSIT 


X 






TSYSGEN2 


X 






DSYSGEN2 




X 




SG5TD 


X 


X 




TTRANSIT 


X 






TAUTOCODE 


X 






DAUTOCODE 




X 




TTRANSIT 


X 






TSYSGENl 


X 






DSYSGENl 62 




X 




PHASE CREATLIB C 


X 






TTRANSIT 


X 






TSRTDEFIN 


X 


X 




TTRANSIT 


X 






TCOBOL 


X 






DCOBOL 




X 




TTRANSIT 


X 






TFORTRAN 


X 






DFORTRAN 




X 




TTRANSIT 


X 






UTILITIES 


X 


X 




TMACROPRT 


X 






LABEL1311 




X 




DMACROPRT 




X 




TTRANSIT 


X 






SYSGEN3 


X 


X 




DSRTDEFIN 


X 


X 




TTRANSIT 


X 






DSKLIBLDR 




X 




IBSGDL (must be lost) 




X 



SG5 PROGRAM 


Create Packet Name 


SG5TD 


16 21 




PHASE SG5 


X 


CALL IBSG5 


X 


PHASE 


X 


CALL IBSG5D 


X 


PHASE 


X 


CALL IBSG5T 


X 


PHASE 


X 


CALL IBSG5E 


X 
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Examples of System Generation for a Tape System 



This section illustrates a series of interrelated System 
Generation jobs for a tape-oriented system. Setup re- 
quirements for the tape units are given for each ex- 
ample. The setup information relates Table 1 ("Basic 
Concepts — Tape-Oriented System") of this publica- 
tion and the asgn cards required by the specific 
example, 

Using the iBM-supplied Master file, the successive 
examples are: 

Example 1 — Generation of sgf 
Example 2 — Generation of modified sgf 
Example 3 — Generation of Autocoder/FORTRAN 

SOF 

Example 1 

Figure 20 illustrates the generation of an sgf from the 
Master file. The user's installation is assumed to in- 
clude a machine of the following configuration. 

System: IBM 1410 with two input/output channels and 

80,000 positions of core storage. 

No Tele-processing 

No disk storage 
Channel 1: 1402 Card Read Punch 

1403 Printer 

Six 729 tape units 
Channel 2: Six 729 tape units 

Note: creatttransit card(s) may be added to 
give additional copy(ies) of Transitional Monitor at 
the time Monitor is generated. 

Contents of New Resident Monitor 

System description control cards define a new System 
Monitor as follows. 

GENOl defines: 

Printer, reader, and punch on channel 1 
GEN02 defines: 

Core Image file 

Six tape vmits on channel 1 ( A0-A5 ) 

Six tape units on channel 2 ( B0-B5 ) 
GEN08 defines: 

IBM 1410 System 

80,000 positions of core storage 

Core Image file 

Unit-record printer 

Unit-record punch 
Alternate input routine ( AIU ) 

55 to be entered in Communication Region, /LIN/ 

Ten-character console input area 

Type and print Monitor control cards 

SOF assigned to AO 

SIU assigned to Rl 

SPR assigned to PI 

SPU assigned to XI 

MDM assigned to B4 

Memory print Snapshot at unusual end of program 



GEN09 defines: 

5 Monitor Reserve files ( MR0-MR4 ) 
GENIO defines: 

5 Monitor work files (MW0-MW4) 

MWl assigned to BO 

MW2 assigned to Al 

MW3 assigned to Bl 
GENU defines: 

No TP files 
DEVDF defines: 

729 tape units on channel 1 

1402 Card Read Punch on channel 1 

1403 Printer on channel 1 
729 tape units on channel 2 

lOKDF defines: 
IBM 1410 System 
Error statistics to be taken 
/OCR/ at 70000 

The following points are illustrated by this example. 

1. The Sort Definition program and one configura- 
tion of the Utility program are generated in addition 
to those that were on the Master file. The Create Li- 
brary packet for the Utility program is not used in 
order to show how the Linkage Loader control cards 
are placed. Also, since there is no disk storage, the 
Disk Print Utility is omitted. 

2. The "L" in card column 58 of the exeq sg3 card 
indicates that the largest size records are to be built. 



MON*« 


DATE YRDAY 
















MONS* 


JOB SAMPLE NO.l 


TO GENERATE 


AN INSTALLATION 


SGF 


MON«« 


ASGN MJB.Al 
















MONSS 


ASGN MW3.A1 
















MONSS 


ASGN MM1.A2 
















MONSS 


ASGN MW2.81 
















MONSS 


ASGN MG0.B2 
















MON«$ 


ASGN MR0.B2 
















MONS« 


MODE GO.SG 
















MONSS 


EXEQ AUTOCODER, SOF, 


.SIU 


.NOFLG 


.NOPCH 








HEADRSAMPLE NO.l 


















GENOIPI .Rl .XI 


















GEN02/MDM/,1 ,A0. 


Al, 


.A2. 


A3, 


• A4, 


A5 








GEN02/MDM/.2.B0, 


Bl, 


iB2. 


B3, 


>B4. 


BS 








GEN081700090H9. 


,55.10 


.099.A0.R1. ,,P1,X1, 


..B4 


.SNAP 




GEN095 


















GEN105..60.A1.81 


















GENII 


















DEVDFl, 729, 1402. 


1403 














DEVDF2,729 


















I0KDF1410,..4, , , 


, , . 


,70000 












END 
















MONSS 


EXEQ SGI 

LOCATC.CREATUB 

INSERC 

L0CATR.IBMH8R 

INSERR 

LOCATM, AUTOCODER 

INSERM 

END 

CREATTMONITOR 

CREATT AUTOCODE 

CREATTSYSGENl 

PHASECREATLIB 

CREATTSRTOEFIN 

CREATTLINKLOAD 

PHASEIBMUBR 

CREATTSYSGEN2 












7 


C 
R 


001 


PHASEUTILITIES 
CALL IBUTILITY 
















002 


PHASE 

CALL IBUTILSCAN 
















003 


PHASE 

CALL IBTAPEDUMP 
















005 


PHASE 

CALLNIBCOREDCTL 
CALL IBCOREOUMP 
END 
















MONSS 


EXEQ LINKLOAO 
INPUTMW2 
















MONSS 


EXEQ SG2 












L7 




MONSS 


END 

















Figure 20. 



Control Cards to Generate an sgf from the 
Master File 
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Setup Instructions 

Setup instructions for this example are: 

1. Mount Master file on AO. 

2. Mount scratch tapes on Al, A2, Bl, B2. 

3. The output tape will be on mw2. ^ 

Example 2 

Figure 21 illustrates the modification of the sgf cre- 
ated in Example 1. 

The following points are illustrated by this ex- 
ample. 

1. The Monitor from Example 1 is copied onto the 
new file. 

2. A two-phase user program (userprog) is added. 
The first phase comprises subprogi and subprogs. The 
second phase consists of subprogs. The relocatable sub- 
programs are added to ibmlibr after compilation. The 
appropriate Linkage Loader control cards have been 
combined into a package and added to creatlib. 



userprog is put into the operating section of the modi- 
fied SGF. 

3. SGI and sgs cards no longer require machine size 
indicators. 

4. The "L" in card column 58 of the exeq sgs card 
indicates that userprog is to be built in largest size 
records. The other programs are already in largest 
size. 

5. Multiple copies of the Transitional Monitor (ib- 
transit) are added to reduce search time during 
future operations. 

6. Mwi, MW3, and mw3 are assigned within Moni- 
tor; therefore, no asgn cards are needed for them. See 
GENio, in Example 1. 

Setup Instructions 

Setup instructions for this example are: 

1. Mount the sgf on AO. 

2. Mount scratch tapes on Al, BO, Bl, B2. 

3. The output tape will be on mw3. 



6 16 21 

MONS« DATE YROAY 

MONS* JOB SAMPLE NO. 2 SGF WITH USER PROGRAM AND IBTRANSITS 

MONSS ASGN MJB.Bl 

MONSS ASGN MG0*B2 

MON»S ASGN MR0«B2 

MONSS MODE GO.SG 

MONSS EXEQ AUTOCODER 

SOURCE DECK FOR SUBPROGRAM NO.l 
SOURCE DECK FOR SUBPROGRAM NO. 2 
SOURCE DECK FOR SUBPROGRAM NO. 3 
MONSS EXEQ SGI 

LOCATC.CREATLIB 
USERPROG INSERC 

GENERUSERPROG 

PHASEUSERPROG 

CALL SUBPROGI 

CALL SUBPR0G2 

PHASE 

8ASE1SUBPR0G2 

CALL SUBPR0G3 

LOCATR. IBMLIBR 
SUBPROGI INSERR 
SUBPR0G2 INSERR 
SUBPR0G3 INSERR 

LOC ATM. AUTOCODER 

INSERM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

INCLDIBTRANSIT 

INCLOAUTOCODER 

INCLDIBTRANSIT 

END 
MONSS EXEQ LINKLOAD 

PHASE'USERPROG 

CALL SUBPROGI 

CALL SUBPR0G2 

PHASE 

BASEISU0PR0G2 

CALL SUBPR0G3 
MONSS EXEQ SGI 

INCLDIBTRANSIT 

INCLOSGt 

INCLDCREATLIB 

INCLDIBTRANSIT 

INCLDLINKLOAD 

INCLDIBMLIBR 

INCLDSG2 

INCLDIBTRANSIT 

END 
MONSS EXEQ SG2 L 

MONSS END 



Figure 21. 
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Control Cards to Modify the sgf Created by the Cards of the Preceding Figure 



Example 3 

Figure 22 illustrates the creation of an sof, designed 
for efHcient Fortran and Autocoder compile-and-go 
operation, from the file created in Example 2. 

The following points are illustrated by this example. 

1. The Go file (mgo) is not required in this job. 

2. The IBMLIBR is stripped to retain only those sub- 
programs required for Fortran and Snapshot. 

3. Th(3 Macro Library is stripped to retain only 
those Autocoder macro routines used by dependent 
programs. The Monitor-generation macro routines are 
deleted. 



4. The CREATLiB is not referenced; therefore, it is not 
included. 

5. FORTRAN is generated from ibmlibr. 

6. userprog is included. 

7. The file is sequenced for eflSciency. 

Setup Instructions 

Setup instructions for this example are: 

1. Mount the modified sgf ( output from Example 2 ) 
on AO. 

2. Mount scratch tapes on Al, BO, B2, B3. 

3. The output tape will be on MW3. 



MONSS 


DATE YROAY 


MONSS 


JOB SAMPLE NO. 3 


MONSS 


ASGN MWl .BO 


MONSS 


ASGN MW2.B1 


MONSS 


ASGN MJB.BZ 


MONSS 


ASGN MR0,B3 


MONSS 


MODE SG 


MONSS 


EXEQ SGI 




LOCATR, IBMLIBR 


IBSRTCOMANDELETR, IBCBL CLEAR 


IBRANDOM 


DELETR.TPLIBGENXP 




LOCATM. AUTOCODER 


6EN01 


OELETM 


GEN02 


DELETM 


GEN03 


DELETM 


GEN04 


DELETM 


GEN05 


DELETM 


GEN06 


DELETM 


GEN07 


DELETM 


GEN08 


DELETM 


GEN09 


DELETM 


GENIO 


DELETM 


GENl I 


DELETM 


OEVDF 


DELETM 


lOKOF 


OELETM 


GENRM 


DELETM 


DUMP 


DELETM 


ENDLD 


DELETM 


LDPTC 


DELETM 


TPOIR 


OELETM 




END 




INCLDIBBOOT 




INCLDIBRESMON 




INCLOIBTRANSIT 




INCLOAUTOCODER 




CREATTFORTRAN 




END 


MONSS 


EXEQ LINKLOAD 




INPUTMW2 


MONSS 


EXEQ SGI 




INCLOIBTRANSIT 




INCLDLINKLOAD 




INCLOIBMLIBR 




INCLOIBTRANSIT 




XNCLOUSERPROG 




INCLOIBTRANSIT 




END 


MONSS 


EXEQ SG2 


MONSS 


END 



SOF WITH AUTOCODER AND FORTRAN 



Figure 22. Control Cards to Create a Fortran/ Autocoder 
SOF from the Output File of the Preceding Figure 
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Disk Load Programs 



This section explains: (1) the use of Disk Load pro- 
gram for loading the entire system, and ( 2 ) the Disk 
Library Loader for loading separately produced re- 
locatable libraries. The Disk Load program operates 
outside the system and requires separate setup and 
operating procedures. The Disk Library Loader 
(dsklibldr) operates within the system as a normal 
job. 

Disk Load Program 

The Disk Load program loads the contents of the disk 
system source tape and library tape onto disk in the 
areas specified by the user. This is the first program 
that appears on the disk Master file. Three configura- 
tions can be loaded by the program: 

1. System tape and library tape physically the same 
reel. 

2. System tape only. 

3. System tape and library tape physically different 
reels. 

When both the system and a library are to be 
loaded onto disk, two logically separate files are cre- 
ated on the disk. 

Note: If specified, the Disk Load program formats 
the areas of the disk required to contain the system 
and the library. Formatting is in Load mode, with geo- 
metric record addressing and with 2,165 character rec- 
ords. Only the specified cylinders are formatted. If 
the file being loaded exceeds the number of cylinders 
specified, a rerun is required. (See description of 
message 21551 under "Console Messages," below, for 
information on how to specify formatting.) Format- 
ting of disk areas required for files (e.g., mgo and 
MP ) used during the System Generation process may 
be accomplished by using the 1301 or 2302 Format/ 
Address Generator utility program. 

Program Description 

During the loading of the system tape, two directories 
are created. Directory 1 is the program directory; 
Directory 3 is the macro directory. Both directories are 
in a form suitable for use by table lookup instructions. 
The argument of each table is the program or macro 
name being sought and the function of each table is 
the corresponding track address of the first record of 
the program or macro. Both tables contain a short 



entry to terminate lookup. Should a program or macro 
contain more than one record, the additional records 
are found in the records that follow sequentially. 

Multiphase programs are intraconnected by control 
data contained in the first 12 characters of the first 
record of each phase. The first four characters of this 
data are the track number of the previous phase of the 
program, if any. If there is no previous phase, this field 
contains blanks. 

The next four characters of the control data are the 
track number of the next phase of the program, if any. 
If there is no subsequent phase, this field contains 
blanks. The next three characters of the data are the 
phase number of the phase located in that record. The 
last character of the field is for special use; it is the 
directory number if that record should be a directory. 

Directory 1 may be more than one record. For this 
situation, the first record is linked to the next by a 
track number in the last four characters of the original 
record. 

The macro directory, Directory 3, is limited in size. 
The maximum number of macro names that can be 
contained in the disk macro directory is 238, and any 
excess is lost. In this case, a diagnostic message is 
issued. 

An additional directory is created as the first ele- 
ment of the Relocatable Library ( a separate file ) . This 
directory is identical in format to Directory 1 and con- 
tains the names of the library subprograms. 

Program Restrictions 

The two program restrictions are: 

1. No two successive directory requests are per- 
mitted. 

2. The program is restricted to channels 1 and 2. 

Setup Instructions 

The system tape, or system tape with library if they 
are on the same physical reel, must always be placed 
on a channel 1 or channel 2 tape unit to run the pro- 
gram. (If the LOAD TAPE button of the ibm 7010 is to 
be used, the reel must be mounted on unit 10. ) 

If the system tape and library tape are physically 
different reels, the library tape must be mounted on 
unit 10 or 20 for the ibm 1410. The system tape can be 
placed on any other channel 1 or channel 2 tape unit. 



68 



For the ibm 7010, the system tape must be mounted on 
unit 10 and the library tape must be mounted on unit 
20. Refer to the Operators Guide for detailed operat- 
ing instructions. 

Console Messages 

The console messages that follow are associated with 
the Disk Load program. Information should be pro- 
vided to the operator so that those messages requiring 
operator action can be handled efficiently. 

Disk Load Program Console Messages 

21551 ENTER START RCD AND CYLS FOR FILE 
ACMTTTTH2zNN 

Description and Action: Enter in the indicated format 
the address from which file is to be started* and number 
of cyhnders to be vised. 

A Access 

C Channel 

M Module 

TTTTH2 Disk geometric record address. (H2 is 
identified as HR under "Organization 
of Data Files on Disk Storage." ) 

z If z is 1 (for 1301) or 2 (for 9302), 

the Disk Load program will format 
the specified area, write H2 and re- 
cord addresses, and load the specified 
area. If z is blank, the Disk Load pro- 
gram will load the specified area. If 1 
is indicated in the format key, the 
specified area will be formatted in 
load mode with a two-character HA2, 
a six-character record address and a 
2,165 character data record. If 2 is 
indicated in the format key, the speci- 
fied area will be formatted in load 
mode with a two-character HA2, a 
six-character record address, a 2,165 
character data record, a second record 
address (one higher than the first), 
and a second 2,165 character data 
record. 

NN Number of cylinders to be used by 

file. 

*This address must agree with the start address indi- 
cated on the GEN03-GEN06 card when the system 
was created. 

21552 FILE XCDS CYL LGTH, PRESS START TO CONT. 
Description and Action: Cylinder length ( NN ) too small. 
If disk format permits, file can be continued by pressing 
START. 

11551 FILE START RCD XXXXXX, LAST RCD XXXXXX. 
Description and Action: Message informs operator of 
area that file occupies. Disk record addresses are of the 
form TTTTH2 as explained for message 21551. 

11553 MAC LIB OVFLO 

Description and Action: Macro library directory is full 
(238 elements) and succeeding macros are lost. 

BOOTSTRAPS 

. . . (card image) . . . 1410 BOOT 

. . . (card image) . . . 7010 BOOT 

Description and Action: Message shows card image of 
bootstrap required to load the first record from disk to 
core storage. Operator must keypunch appropriate card 
for his machine (IBM 1410 or 7010) and place card 



in SIU. See the publication Operator's Guide for com- 
plete procedure. 

01551 END JOB 

Description and Action: All operations are complete. 
System tape (and library tape, if any) has been loaded 
as specified by the character entered at location 00000 
or by the contents of the system file being loaded. 

21553 (Same as message 21551) 

Description and Action: Same description and action as 
message 21551 except that this message pertains to the 
disk location desired for the Relocatable Library. 

21554 (Same as message 21552) 

Description and Action: Same as message 21552 except 
that this message 21554 pertains to the Relocatable 
Library. 

11552 (Same as message 11551) 

Description and Action: Same as message 11551 except 
that this message 11552 pertains to the Relocatable Li- 
brary. 

11554 INVALID FILE, NO DIR 1 REQUEST 
Description and Action: System will not operate without 
Directory 1 which was not requested by Linkage Loader 
card. 

11555 NO TAPE LABEL FOUND 

Description and Action: Library tape was indicated to 
have a tape label by word mark entered in 00000, but 
no label was found. 

11556 NO RLIB HEADER FOUND 

Description and Action: Tape designated as Relocatable 
Library by character entered in 00000 does not contain 
the Relocatable Library header. 

Note: The iocs may generate other messages due 
to seek checks, no record found, etc. These may be 
caused by operator error in making console entries, 
incorrect formats, or disk unit malfunctions. The oper- 
ator may cancel console inquiries in the event of error. 



Disk Library Loader (DSKLIBLDR) 

The Disk Library Loader loads the contents of a sepa- 
rate relocatable library tape onto the disk. This load 
program is a subprogram of the Master file. The li- 
brary tape to be loaded must be on symbolic unit 
Mwi, and the disk area loaded is that which is as- 
signed as LIB. 

Program Description 

The first record of the file loaded on the disk is a di- 
rectory of library subprograms that is built as the file 
is loaded. A brief description applicable to this direc- 
tory is given earlier, under "Disk Load Program." The 
library tape is read in Move mode, and the disk is 
written in Load mode. 

Setup Instruction and Use of Program 

The relocatable library tape must be mounted on sym- 
bolic unit Mwi. 

The following example shows how the Disk Library 
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Loader is used to load a relocatable library tape into Disk Library Loader Console Messages 



LIB on disk storage 


a 




6 


16 


21 


MON$$ 


JOB 


LOAD SEPARATE RELOC 
LIBE 


MON$$ 


ASGN 


MW1,A5 


MON$$ 


ASGN 


LIB,D8 


MON$$ 


EXEQ 


DSKLIBLDR 


MON$$ 


END 





Console Messages 

The console messages that follow are associated with 
the Disk Library Loader. 



91558 NO RLIB HEADER FOUND 

Description and Action: Neither of the first two tape 
records was a relocatable library header. Control is re- 
turned to Monitor with NOGO switch turned on. 

91556 RLIB XGDS DISK AREA 

Description and Action: The Relocatable Library is too 
large to be loaded in the disk area assigned as LIB. 
Control is returned to Monitor with the NOGO switch 
turned on. 

11557 RLIB START RCD XXXXXX, LAST RCD XXXXXX 
Description and Action: Informs operator of disk area 
which relocatable library occupies. Disk record addresses 
are of the form TTTTH2 as explained for message 
21551, "Disk Load Program." 
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SGI and SG2 Diagnostic Messages 



The SGI and sgs diagnostic m<3ssages are listed in this 
section with an explanation of the message and sug- 
gested corrective action for: (1) tape-oriented systems, 
and (2) disk-oriented systems. 



Tape-Oriented System 

Diagnostic messages that may be produced on the con- 
sole printer during execution of soi and sgs are listed 
in sequence by message number in the following sec- 
tion. When one of these messages appears, processing 
halts and special end of program occurs unless the 
"Corrective Action" comment states that processing 
will continue or that no corrective action is to be taken. 
After the correction is made, the job must be rerun. 
Full instructions appear in the publication, Operators 
Guide. 

SGI and SG2 Diagnostic Messages for a Tape-Oriented 
System 

11501 XXXXXXXXXX NOT ON TAPE 

Explanation: Request has been made for the named 
item but it cannot be located on the SOF or on the 
Relocatable or Create Library. 

Corrective Action: Check control deck for proper call 
and/or spelling, etc. 

11502 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number has 
been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11503 DIRECTORY X NOT AVAILABLE 
Explanation: X can be "1" or "3." 

Corrective Action: Check the control deck to make sure 
directory has been generated previous to this reference. 
If X is not 1 or 3, the PHASE card for the directory has 
been mispunched. 

11504 XXXXXXXXXX LIBRARY NOT AVAILABLE 
Explanation: Request has been made for the named 
library but that library cannot be located or does not 
exist. 

Corrective Action: Check the control deck to make sure 
that a library of the name XXXXXXXXXX has been 
copied, updated, or added by SGI. 

11505 NEW SOF ON XXX 

Explanation: XXX is the x-control field for the unit 
on which the System Generation output file is located.. 
Corrective Action: None. 

11507 LIB TYP UNKNOWN 

Explanation: Request has been made for a library 
whose type is not M, R, or C. 

Corrective Action: Check control deck. The PHASE 
card for the Hbrary header may have been punched 



incorrectly. The M, R, or C must be in column 62 of 
the PHASE card. 

11508 BACKSPACE FAILURE - SOF 
Corrective Action: Restart. 

1 1509 BACKSPACE FAILURE - MJB 
Corrective Action: Restart. 

11510 NEW LIBRARY ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new library is located. 
Corrective Action: None. 

11511 UNKNOWN HDR TYP 

Explanation: Header record is not proper format. 
Corrective Action: Check control deck. Check that all 
the libraries processed by SGI were done in one block 
and were processed before absolute programs. Also 
check that no conflict exists in input/output assignments. 

11512 NO TYPC COUNTS 

Explanation: Specific cause has not been determined. 
Corrective Action: Check control deck for extraneous 
PHASE cards, order of cards, etc. 

11513 EXTRANEOUS HEADER 

Explanation: Record descriptions contained on MWl 
(header records) do not agree with contents of Job file. 
Corrective Action: Ensure that all requests for SGI to 
INSER, DELET, REPLC, and ADD library material 
were made prior to requests to process absolute format 
records. Also check that no conflict exists in input/out- 
put assignments. 

11514 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11515 MODULE XXXXXXXXXX NOT ON GO TAPE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

1 1516 SOF RECORD TOO LARGE TO COPY 

Explanation: SGI, when working with largest possible 
records, cannot copy an SOF on a smaller machine than 
was used to generate the SOF. 

Corrective Action: The records on the SOF cannot be 
copied on the size machine being used, with SGI based 
where it is. Regeneration of the SOF is necessary. 

11517 NO ALTERNATE LIBRARY HEADER 
Explanation: SGI has been directed to find an external 
library, but did not find an identifying header record 
on LIB. 

Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11518 (No message) 

Explanation: A macro routine or a model statement has 
been specified, but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SGI may be out of sequence. 
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11519 MACRO DIR EXCEEDS 240 

Explanation: The Macro Library can have only 240 
entries, and this number has been exceeded. 
Corrective Action: Reduce number of macro routines to 
specified limit. 

11520 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were followed 
by an END card. No action is required if all other cards 
are in order. 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates 
a header is desired on the output tape. The card follow- 
ing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2." 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11523 SOF EXCEEDS 154 LIMIT 

Explanation: Tape SOF may have no more than 154 
items, and this number has been exceeded. 
Corrective Action: Deck may be in error. Some items 
may have been copied several times. 



Disk-Oriented System 

Diagnostic messages that may be produced on the 
console printer during execution of sgi and sg3 are 
Hsted in sequence by message number in the follow- 
ing section. When one of these messages appears, 
processing halts and special end of program occurs 
unless the "Corrective Action" comment states that 
processing will continue or that no corrective action 
is to be taken. After the correction is made, the job 
must be rerun. Full instructions appear in the Oper- 
ator's Guide. 

SGI and SG2 Diagnostic Messages for a Disk-Oriented 
System 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates a 
header is desired on the output tape. The card fol- 
lowing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2". 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11562 CREATLIB NOT ON SOF 

Explanation: SGI has been executed, but the Create 
Library is not on the system. 

Corrective Action: An SOF that includes the Create 
Library must be generated and this SOF used to proc- 
ess the job that caused the message. 



11563 PACKAGE XXXXXXXXXX NOT IN CREATLIB 

Explanation: No packet of the name XXXXXXXXXX 
has been found in the Create Library by SGI. 
Corrective Action: Check the control deck to be sure 
that spelling on GREAT card is correct. 

11564 OUTPUT ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new output file is located. 
Corrective Action: None. 

11565 DISK LOADER NOT PRESENT 

Explanation: IBSGDL has not been included or gener- 
ated as the first item. 
Corrective Action: Rerun the job including IBSGDL. 

11566 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were fol- 
lowed by an END card. No corrective action is neces- 
sary if all other cards are in order. 

11567 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11568 (No message) 

Explanation: A macro routine or a model statement has 
been specified but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SG2 may be out of sequence. 

11569 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number 
has been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11570 ALTERNATE LIBRARY HEADER 

Explanation: SG2 has been directed to find a library 
but did not find an identifying header record on LIB. 
Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11571 MODULE XXXXXXXXXX NOT ON GO FILE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11572 XXXXXXXXXX NOT AVAIL 

Explanation: An INCLD card has specified the name 
of an item which is not in the system. 
Corrective Action: Check control deck for proper spell- 
ing of item name. 

11573 XXXXXXXXXX NOT VALID 

Explanation: An INCLD card has specified the name 
of an item which does not contain valid program infor- 
mation. The area assigned to SOF (on the disk) has 
been accidentally altered or destroyed. 
Corrective Action: Reload the SOF from the output tape 
from the previous System Generation run. 
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System Maintenance 



Additions and improvements to the Operating System 
require updating of the Relocatable, Create, and 
Macro libraries. The sg5 program provides a simpli- 
fied method of updating these libraries with a mini- 
mum of card handling. 

Input to the sgs program is: 

1. A modification tape (supplied by ibm) 

2. The user's sof, sgf, or Master file 

3. The required System Monitor control cards (job, 

ASGN, EXEQ, etC. ) 

Execution of sgs produces an output containing: 

1. Change data 

2. Control cards to eff^ect these changes 

3. Control cards required to perform functions asso- 
ciated vi^ith generation of an sof (exeq, inser, 

ASGN, INCLD, CtC. ) 

The control data generated by sgs becomes siu in- 
put. This input directs execution of the operations re- 
quired to make a normal System Generation update 
run. The final output is an sof, sgf, or Master File 
identical to the original except that the Relocatable, 
Create, and Macro libraries have been updated and 
represent the latest version of the Operating System 
libraries. 

The output of SG5 provides the control cards that 
the user normally would code, key punch, and verify 
prior to performing maintenance on his system files. 

A second program, sg4, is also available, ibm uses 
this program to create the modification tape the user 
receives. Some users will not require this program, 
but those with system libraries other than the ones 
supplied by ibm will find that sg4 facilitates mainte- 
nance of these libraries. To generate his own modifica- 
tion tape, the user employs sg4 with the system file, 
the required control cards, and the change modules 
(see "The sg4 Program" in this section). Figure 23 
is a summary of the use of the sg4 and sgs programs 
and the modification tape. 

If the operating section of the modified system file 
is affected by the library changes and the user wishes 
to incorporate them, another System Generation run 
must be made. The update run with the siu prepared 
by SGS can update only the Macro, Create, and Re- 
locatable Libraries. 

Modification Tape 

The modification tape contains the following data: 
1. Two directory records of 2,500 characters each 
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Figure 23. System Maintenance 

2. Card-image data records blocked into 2,000-char- 
acter physical records. These data records con- 
tain library changes preceded by their respective 
control cards 

3. End of File (tape mark) 

4. Standard 120-character trailer label 



5. End of File (tape mark) 
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The Relocatable Library modules are blocked so 
that each module begins with a new record, but the 
module can be more than one record long. Padding 
with 9's is used if the module does not complete a 
record. The Macro and Create Library changes are 
continuously blocked (i.e., a new record is not begun 
for each new Macro or Create packet), and padding 
is added to the last record only, if required. 

Both the directory of changes on the tape and a list 
of the control cards generated are printed automatic- 
ally at the end of the sg4 run. ibm includes these 
listings when it supplies the modification tape. 

The directory of changes is useful for checking that 
all desired modifications are included. It is printed 
with five entries per line, each line having the follow- 
ing format: 

ProgrnamelbWbxxxxbbbbbProgrname2bWxxxx . . . etc. 
Ten characters are allowed for the program name. 
W can be R, M, or C according to the type of library 
being changed; b indicates a blank; and xxxx is the 
four-character record count ( see Figure 24) . 

The control cards are listed one card per line as 
follows: 

xxxbbbProgrnamelbyyyyyW 
The three-character sequence number (xxx), which is 
required by sg5, is followed by three blanks; ten char- 
acters are allowed for the program name; yyyyy is 
the type of card, either replc, inser, or delet; and 
W is R, M, or C according to the type of library being 
changed (see Figure 25). 



The SG4 Program 

Usually, the user updates his History file just prior to 
using SG4. The sg3 program (see Appendix A in this 
publication) performs the update and, at the same 
time, places Autocoder source statements on mw6. 
These source statements are then processed by the 
Autocoder processor in the normal manner. sg4 gen- 
erates the modification tape using control card in- 
formation and Autocoder output. sg4 can process a 
maximum of 199 program modules in one run. A flow- 
chart showing one use of SG4 is shown in Figure 26. 

Machine Requirements 

SG4 requires two tape units in addition to the sof. 
Mwi must be assigned as a work file for the sg4 run. 
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Figure 25. Control Card List 
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Figure 26. SG4 Update Data Flow 

and MW2 must be assigned to the modification tape 
that SG4 is generating, mwi and mw3 must be tape 
units; the sof can be a tape or disk unit. If the modi- 
fications have been put on the Go file, mgo must also 
be assigned. 
The tape files are in Move mode and odd parity. 
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Figure 24. SG4 Directory 
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SG4 can handle files with a maximum of 550 records of 
2,000 characters each, or 14,000 records of 80 char- 
acters eadb. 



Input Format 

The input tape for sg4 can contain three types of ele- 
ments: Macro patches, Create packets, and Relocat- 
able Library modules. These elements must appear in 
the order given below. Each element that is an in- 
sertion or replacement must be preceded by its sgi/ 
SG2 control card(s). 

1. Macro patches, each patch preceded by a replcm 
or INSERM control card. 

2. Create packets, each packet preceded by an 
iNSERC or REPLCC Card and a gener card. 

3. Relocatable Library modules, each module pre- 
ceded by an inserr or replcr card. 

delet cards can be used to remove any library ele- 
ment. The delet card must not have library cards 
immediately following. 

Within each type of element (Macro, Create, or 
Relocatable), the changes for the modules should be 
in the same order as the modules on the system file 
to be updated by sg5. If the programmer follows this 
practice, he can shorten the sg5 run by reducing the 
search time. If the order of the elements is not known, 
the only disadvantage is a longer execution of sg5. 

If SG4 reads an inserr or ]\eplcr control card and 
no Relocatable Library module follows it, sg4 searches 
the Go file for the name as it appears in columns 6 to 
15 of the control card. sg4 finds and reads the module 
from the Go file and processes the module normally; 
if SG4 does not find the module, an error message is 
printed. 

Figure 27 is an example of a typical sg4 deck. 



Messages 

The following messages indicate that the output of 
SG4 is invalid. The number of the message is printed 
on the console typewriter; the text, on the spr. A con- 
dition producing any of these messages terminates 
the program. 

11544 UNCORRECTABLE ERROR ON SIU 
Explanation: The input tape; has a read error that cannot 
be corrected. 

Corrective Action: Rerun the job with a new input tape. 

11545 UNCORRECTABLE ERROR ON MWl, MW2, or MOO 
Explanation: The indicated tape file has a read or write 
error that cannot be correct(;d. 

Corrective Action: If the error is on MWl, or MW2, 
rerun the job with a new tape. If the error is on MGO, 
rerun with a backup MGO file. 



6 

MONS$ 
MONIS 
MONSt 
MONS> 
MONSt 
MON$» 
HONS» 
MONSS 
HON$$ 
NONS$ 
MON$$ 



16 21 
DATE 12345 
JOB SG4 
ASGN MG0>A6 
ASGN MMl.Bl 
ASGN HM2tA2 
ASGN NW3,B3 
ASGN HW4,A4 
ASGN MW5.A5 
ASGN MW6.B6 
MODE 60 
EXEQ SG3 



... CONTROL CARDS TO CAU SYMBOLIC DECKS FROM HISTORY FILE ••. 



MONS» EXEQ AUT0C0DERt>HW6.N0PCH 

MON»$ EXEQ SG4 

GET INSERMtAAAAA 

... CHANGES •»• 

GET REPLCM, AAAAAtBBBBB 

... CHANGES .•• 

GET 0ELETM,AAAAA~.66BBB 

GEN08 INSERMtAAAAA 

... CHANGES ..• 

GENIO DELETM. AAAAAtBBBBB 

TSYSTEM REPLCC 

GENERTSYSTEM 
... SYSTEM GREAT PACKET ... 
DSYSTEM DELETC 
TDLINKLOAOINSERC 

GENERTDLINKLOAO 
... TDLINKLOAD CREAT PACKET *•• 
SNAPSHOT REPLCR RELOCATABLE 

IBAUIOIOTBREPLCR PROGRAMS ARE 

FILESAVE INSERR, FILEREST TAKEN FROM 
IBUPPER DELETR GO FILE 

MON$$ END 

Figure 27. Typical SG4 Control Card Deck 



The following diagnostic messages indicate errors 
in the input to the program. When any of these errors 
occur, SG4 continues to edit the input for further errors 
but stops processing the input. The messages appear 
with the number on the typewriter console and the 
text on the spr. 

11546 FILE CAPACITY EXCEEDED 

Explanation: The output file produced is larger than the 

maximum allowed. 

Corrective Action: Shorten the input file and rerun the 

job. 

11547 DIRECTORY CAPACITY EXCEEDED 
Explanation: The capacity of SG4, which is 199 program 
modules, has been exceeded. 

Corrective Action: Reduce the number of program mo- 
dules and rerun the job. 

11548 MWl or MW2 NOT ASSIGNED TO TAPE 
Explanation: The MWl or MW2 has not been assigned 
as a tape file, as required by SG4. 

Corrective Action: Reassign MWl or MW2, as required, 
and rerun the job. 

11549 n BAD INPUT CARD **** (contents of card) 
Explanation: n indicates the type of error, as follows: 

Format 

1 Sequence 

2 Title card 

3 Duplicate entry 

4 GENER card error 

5 Control card missing 

6 Module missing on Go file, or no Go 
file 

Corrective Action: Correct the card in error or supply the 
proper card. 
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The SG5 Program 

The SG5 program prepares the tape siu that is used for 
incorporating the changes to the Macro, Create, and 
Relocatable libraries into the sof, sgf, or Master File. 
This siu includes the control cards required for the 
System Generation update run as well as the changes 
to be made to the system files. 

Two options are available with the program, the 
OMIT option and the edit option. The omit option per- 
mits the user to incorporate changes to only as many 
modules as he chooses. However, he must be careful 
in choosing to omit any modification. All IBM modifi- 
cation level changes are made on the assumption that 
all previous modification levels have been incorpo- 
rated into the user's system files. If the user omits any 
modification level change, he must make certain that 
later changes to his system files do not make his pro- 
grams inoperable. 

Note: sg5 automatically omits any attempt to make 
a change to a program not in the user's Macro, Cre- 
ate, or Relocatable Libraries; therefore, the user does 
not need to specify omission of a change to a module 
not on the system files. 

The EDIT option gives the user a method of chang- 
ing a Relocatable Library module on an sof tape li- 
brary other than ibmlibr or to respecify the insertion 
point of a Relocatable Library module on the sof. 

In all cases, the input information supplied by the 
user is checked by the program to ensure a satisfac- 
tory run. 

At the end of the sg5 run, the program prints a list 
of the element names that were put on the siu for up- 
dating (see Figure 28). The elements are not neces- 
sarily listed in the order in which they were processed. 
The user can compare this list with the directory list- 
ing of the modification tape to check that the proper 
modifications were made. 

Machine Requirements 

The machine configuration required by sg5 depends 
upon the physical units on the user's system. A tape- 
oriented system requires at least three tape units. If 
the EDIT option is used, an additional tape unit is re- 
quired. A disk-oriented system requires at least two 
tape units. If the edit option is used, an additional 
tape unit is required. 

Note: The program can be run with a minimum 



disk system having only one tape unit available to the 
Operating System, but additional time is required for 
the SG5 run, and the tape reel must be changed during 
the run. 

The modification tape for the sg5 run (supplied by 
IBM or prepared by the user with an sg4 run) must 
be mounted on the physical unit assigned to mw3. 
From the modification tape and the controlling sof, 
sgf, or Master File, sg5 prepares a new tape siu on 
Mwi. The new siu is the input tape for updating the 
user's system file. This siu can be used only to update 
a system file that was used on the sg5 run or one that 
is exactly the same; therefore, a separate siu should 
be prepared for updating each system file configura- 
tion. 

SG5 opens the necessary system files as tape or disk, 
according to the physical equipment of the user's sys- 
tem. Figure 29 is a summary of the machine configu- 
ration and assignment requirements for sg5. 

Control Cards 

Several control cards define the operation of the sg5 
program. Two types of control cards are required: a 
Monitor exeq control card and Pseudo Monitor con- 
trol cards. Optional cards are also available to accom- 
modate particular requirements of users. 

The Monitor control card and the Pseudo Monitor 
control cards define the system to the program. They 
specify an sg5 execution and describe the job and the 
assignment of the physical units for the update run. 

The optional cards are for those systems in which 
the configurations of the system files differ from those 
of the usual Operating System files. The control card 
for the OMIT option permits the user to omit updating 
of any of the program modules in the relocatable 
libraries. The cards used with the edit option permit 
the user to incorporate a change for a relocatable pro- 
gram on a system library other than that named 
IBMLIBR. In the case where the library has been re- 
arranged, the change cards can be used to respecify 
the insertion point of a new module. 

Insertions of new modules are made as specified by 
the SGi or sg3 control cards. In the case of the Relo- 
catable Library on a tape system, all insert statements 
with only one name are inserted at the end of ibmlibr 
unless an edit pass has been performed to direct the 
insertion to another library. 



GET 


N 


0014 


GEN08 M 0011 


lOKDF H 


0231 


IBIIWXl R 0001 


IBINDXZ R 0001 


IBINDX3 


R 


0001 


IBEXPFI R 0001 


IBEXPFF R 


0001 


EXP R 0001 


IBCBLP2MF1 R 0520 


IBFTN20 


R 


0328 


IB1301DUHP R 0150 


IBFILESAVE R 


0176 


IBFILEREST R 0158 





Figure 28. Listing of Update Elements 
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user's physical system 


FILE 


SYMBOLIC UNIT 


PHYSICAL UNIT TYPE 


Normal Tape System 


Modification Tape 


MW3 


Tape 




User's System File 


SOF 


Tape 




SIU Output File 


MWl 


Tape 


(With EDIT option) 


( Program Work File ) 


(MW4) 


(Tape) 


Normal Disk System 


Modification Tape 


MW3 


Tape 




User's System Files 


SOF 


Disk 






LIB 


Disk 




SIU Output File 


MWl 


Tape 


(With EDIT option) 


( Program Work File ) 


(MW4) 


(Tape) 


Minimum Disk System— with DMIN Parameter 


Modification Tape 


MW3 


Tape 




Interim SIU 


MW2 


Disk 




User's System Files 


SOF 


Disk 






LIB 


Disk 




SIU Output File 


MWl 


Tape— same unit as assigned to MW3 


(With EDIT option) 


( Program Work File ) 


(MW4) 


( Tape- same unit as assigned to MW3 
and MWl ) 



Figure 29. SG5 File Assignments 



Monitor Control Cards 

The following Monitor exeq control cards cause the 
execution of sg5. If the parameters specifying both 
the EDIT option and the minimum disk system are 
used, they can be in either order, but they must be 
the fourth and fifth parameters of the Monitor Exe- 
cute card: 

MON$$ EXEQ SG5 

This card directs SG5 to build a tape SIU to update the 
user's tape or disk system file, SG5 reads the modification 
tape on MW3, and writes the new tape SIU on MWl. 

MON$$ EXEQ SG5,,,DMIN 

This card directs SG5 to build the tape SIU for updating a 
file on a minimum disk system and the user's Relocatable 
Library at LIB. The DMIN parameter indicates that the 
user's system has only one tape unit. SG5 reads the modi- 
fication tape on MW3 and writes the SIU information on 
disk unit MW2. The program then enters a wait loop to 
permit a different tape reel to be mounted on the tape 
unit. (This unit must be assigned to MWl as well as to 
MW3. ) A message typed on the console typewriter indi- 
cates that the wait loop has been entered. When the tape 
reel is ready, the operator must enter a $50 message to 
break the wait loop and resume processing. SG5 then 
writes the tape SIU information on the tape unit. 

MON$$ EXEQ SG5, , , EDIT 

This card permits the user to modify a Relocatable Library 
module on a system library other than IBMLIBR or to 
change any control card for the Relocatable Library. This 
Monitor control card tells SG5 that a special EDIT pass 
will change Relocatable Library control cards in the SG5 
program supplied by IBM. The control cards that can be 
changed at the time of this EDIT pass are INSERR, 
DELETR, and REPLCR. Every modification released hy 
IBM is built to accommodate the Relocatable Library as it 
appeared on the last IBM Master file released. When the 
customer receives the modification tape, he should check 
the enclosed list of Relocatable Library control cards. Every 
Class IV, Format 3 INSER card; Class IV, Format 2 DE- 
LET card; and Class IV, Format 2 REPLC card should be 
noted with care because the module identified by the 
second name on each of these statements must be located 
exactly where specified by the card. If any modules have 
been relocated, an EDIT pass must be performed to replace 
the control card supplied by IBM with cards describing the 



altered locations of the modules ( see "Edit Control Cards" 
in this section ) . All Class IV, Format 2 insertions are made 
at the end of the Relocatable Library IBMLIBR unless the 
EDIT pass is made to direct the program to insert the 
module into another library. 

Pseudo Monitor Control Cards 

The Monitor exeq control card must be followed by 
Pseudo Monitor control cards. These control cards 
describe to sg5 the physical environment of the sys- 
tem for the update run. Note that, while the cards 
resemble Monitor control cards, the Pseudo Monitor 
must not contain mon$$ in columns 6 to 10. In the 
following card formats, xx represents tape physical 
units to be assigned by sg5, and yy represents disk 
physical units to be assigned by sg5. 



( Optional, used for tape or 
disk system) 

( Used for a tape system only ) 
( Used for tape or disk system ) 
( Used for a tape system only ) 
( Used for tape or disk system ) 
( Used for a disk system only ) 



Edit Control Cards 

If the user must change the Relocatable Library con- 
trol cards, he must specify an edit pass by using the 
edit parameter in the mon$$ exeq control card. He 
must also supply a card in the following format for 
each library control card being changed. 

16 16 21 

XXX namel yyyyy R, name2 

In the above control card format, xxx is the sequence 
number as it appears on the modification tape direc- 
tory listing; namel is the name of the module affected 
by the change in the control card; yyyyy is the type 



16 


21 


ASGN 


MDM,xx 


JOB 


Anyname 


ASGN 


MWl,xx 


ASGN 


MW2,xx 


ASGN 


MRO,xx 


ASGN 


MTB,xx or yy 


ASGN 


LIB,yy 


ASGN 


SPR 


EXEQ 


SGI 


EXEQ 


SG2 



System Maintenance 77 



of card, either inser, delet, or replc; and name2 is 
the second name on the system generation control 
card. 

If a Class IV, Format 2 inser card change is to be 
made to a library other than ibmlibr, the edit card 
for that library must be preceded by the following 
card. 



16 
TLIB 



21 
libname 



The name of the library in which the insertion is to be 
made is libname. No more than 50 tlib cards can be 
included in any one deck. 

Figure 30 is a summary of the edit control cards. 
If the edit parameter is used on the Monitor control 
card, at least one of the following cards (or set of 
cards) must appear in its proper place in the deck. 



Col Col 
1 6 


Col 
16 


Col 
21 


Comments 


XXX namea 


INSER 


R,newnamel 




XXX nameb 


REPLC 


R,newname2 




XXX namec 


DELET 


R,netvnaTne3 




XXX namen 


TLIB 
INSER 


libname 
R 


This set of cards directs 
namen to libname rather 
than to IBMLIB 



NOTE: Sequence numbers (xxx) must be in ascending se- 
quence. They are obtained from the listing supplied with the 
modification tape. 



Figure 30. Summary of edit Control Cards 



OMIT Control Cards 

The omit card specifies to sg5 which of the program 

modules residing on the user's system file are not to 

be updated. The omit card has the following format: 

16 21 

OMIT ProgramA, ProgramB, ProgramC, . . . etc. 

The operands starting in column 21 list the names of 
the Macro patches, Create packets, or Relocatable 
Library modules to be omitted in the updating. 

Any replacement element included on the modifica- 
tion tape, but not on the user's sof, is automatically 
omitted by sg5. 

Note: If the user omits the updating of any ibm 
library modules on his system files, later changes to 
these libraries may make his programs inoperable 
unless a careful check is made at each succeeding 
modification level. 

Control Card Sequence 

The SG5 control cards must appear in the following 
sequence: 



Monitor job card 
Monitor asgn cards 

One Monitor exeq control card with all the neces- 
sary parameters 
edit control cards (if any) 
Pseudo Monitor cards describing the job and the 

physical system 
OMIT cards (if any) 
The Pseudo Monitor control cards that follow the 
Monitor Cards (and edif cards, if used) must be one 
of the following sets. The symbolic unit assignment 
must be as shown here; however, the physical unit 
assignment depends upon the user's system. 
Tape System 



I 



16 


21 




ASGN 


MDM,xx 


( Tape unit, 


JOB 


SG5 UPDATE 




ASGN 


MW1,A2 


(Tape unit) 


ASGN 


MW2,B2 


(Tape unit) 


ASGN 


MR0,A3 


(Tape unit) 


ASGN 


MJB,B3 


( Tape unit ) 


EXEQ 


SGI 




EXEQ 


SG2 




ASGN 


SPR 




Disk System 






16 


21 




ASGN 


MDM,xx 


( Tape unit, 


JOB 


SG5 UPDATE 




ASGN 


MW2,B2 


(Tape unit) 


ASGN 


MJB,D3 


(Disk unit) 


ASGN 


LIB,D2 


( Disk unit ) 


EXEQ 


SG2 




ASGN 


SPR 





Examples of Control Card Decks 

Figures 31, 32, 33, and 34, respectively, are examples 
of control card decks for a tape system, a tape system 
with EDIT modifications, a normal disk system, and a 
minimum disk system with edit modifications. The 
MON$$ JOB and mon$$ asgn cards preceding the 
MON$$ EXEQ card are the normal control cards for 
the execution of any program (in this case, sgs). 
The Pseudo Monitor job and asgn cards prepare as- 
signments for the subsequent use of the siu tape. 
The sequence numbers are obtained from the modi- 
fication tape control card listing. No other sequence 
numbers should be used. 

Messages 

Both console and diagnostic messages are used in sg5. 
All diagnostic messages appear on the spr; the mes- 
sage number, 11559, is printed on both the console 
typewriter and the spr. Diagnostic messages indicate 
that there are one or more errors in the information 
supplied to the program by the user. The message on 
the SPR may indicate the corrective action to be taken. 
The following diagnostic messages are used: 
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16 21 



MONSS 


JOB SG5 NORMAL 


TAPE 


SYSTEM 


MON$$ 


ASGN MW1,A2 






OUTPUT TAPE 


NON$$ 


ASGN HW3.B5 






MODIFICATION INPUT TAPE 


MON$* 


EXEQ SG5 










JOB USER JOB 


NAHE 






ASGN HW1.A2 






ASSIGNMENTS FOR 




ASGN HW2.B2 






SUBSEQUENT SYSTEM 




ASGN HJB>A3 






GENERATION UPDATE 




ASGN HR0t63 






RUN 


MON«$ 


END 









Figure 31. Example for Tape System 



6 

MONtS 
MONt$ 
MONt$ 
MONtS 
MON:($ 



16 21 
JOB S65 TAPE UPDATE AND EDIT 



OUTPUT TAPE 
MODIFICATION 
WORK TAPE 



003 
017 



ASGN HW1,A2 

ASGN MW3,B5 

ASGN MW4«A3 

EXEQ SG5,,,EDIT 
PROGNAMEA REPLCRtPROGNAMEB 
PROGNAMEX DELETR.PROGNAMEY 

TLI6 USERLIB 
025 PROGNAMEZ INSERR 

JOB USER JOB NAME 

ASGN MW1,A2 

ASGN MH2,B2 

ASGN MJB.B2 

ASGN MR0tB3 

OMIT PR06NAME1.PR0GNAME2 

OMIT PR0GNAME4 
MON»S END 



Figure 32. Example for Tape System with EDIT 



INPUT TAPE 



EDIT PHASE CONTROL CARD 
EDIT PHASE CONTROL CARD 
EDIT PHASE CONTROL CARD 
EDIT PHASE CONTROL CARD 

ASSIGNMENTS FOR 
SUBSEQUENT SYSTEM 
GENERATION UPDATE 
RUN 



16 



21 



MON$i 


JOB SG5 DISK UPDATE 




MONSS 


ASGN MW1.A2 


OUTPUT TAPE 


MONti 


ASGN MW3.B5 


MODIFICATION INPUT TAPE 


MONSt 


ASGN LIB.D5 


DISK LIBRARY FILE 


MON$$ 


EXEQ SG5 

JOB USER JOB NAME 






ASGN MW2,B2 


ASSIGNMENTS FOR 




ASGN LIB,D2 


SUBSEQUENT SYSTEM 




ASGN MJB.D3 


GENERATION UPDATE RUN 




OMIT PR0GNAMElfPR0GNAME2 


MONi$ 


END 





Figure 33. Example for Normal Disk System 



1 


6 


16 21 






HONtS 


JOB SG5 DISK UPDAfE 






HONtS 


ASGN MWl.AZ 


OUTPUT TAPE 




HON»$ 


ASGN MW3.A2 


MODIFICATION INPUT TAPE 




MONtt 


ASGN MW4,A2 


WORK TAPE 




MONUi 


ASGN LIB. 01 


SYSTEM LIBRARY FILE 




HONtS 


ASGN HW2,D5 


INTERIM SIU 




HON)>S 


EXEQ SG5...ED1T,DMIN 




003 


PROGNAMEA 


REPLCR.PROGNAHEB 


EDIT PHASE CONTROL CARD 


017 


PROGNAMEX 


OELETR.PROGNAMEY 


EDIT PHASE CONTROL CARD 


025 


PROGNAMEZ 


INSERR, PROGNAMEZ 
JOB USER JOB NAME 


EDIT PHASE CONTROL CARD 






ASGN HH2.A2 


ASSIGNMENTS FOR 






ASGN LIB.D2 


SUBSEQUENT SYSTEM 






ASGN MJB.D3 


GENERATION UPDATE RUN 






OMIT PROGNAMEl 






MONSt 


END 





Figure 34. Example for Minimum Disk System with EDIT 



11559 UNCORRECTABLE I/O ERROR ON SYSTEM TAPE 
Explanation: A read error occurred on the system tape. 
Corrective Action: Run the job with a backup or with a 
new system tape. 

11559 INCLD TABLE CAPACITY EXCEEDED 

Explanation: The program attempted to make more than 
300 entries in the table of program modules being modi- 
fied (e.g. Autocoder, IBTRANSIT, etc.). 



Corrective Action: Reduce the number of program mod- 
ules on the SOF. 

11559 TLIB DIRECTORY CAPACITY EXCEEDED 

Explanation: The program has attempted to enter more 
than 50 EDIT operations in the TLIB Directory. 
Corrective Action: Reduce the number of entries to the 
directory by reducing the number of TLIB card specifi- 
cations and rerun the job. 

11559 CONTROL CARD DECK IN ERROR - CORRECT 
AND RERUN 

Explanation: There is an error in the card deck. 
Corrective Action: Correct the deck and rerun the pro- 
gram. 

11559 READ ERROR ON SIU 

Explanation: A read error occurred on the SIU. 
Corrective Action: See Operator's Guide for the standard 
procedure for SIU errors. 

11559 ERRONEOUS EOF ON MW4 

Explanation: No EOF should occur on MW4 during an 

EDIT run. 

Corrective Action: Rerun after changing the tape on 

MW4. 

11559 ERRONEOUS EOF ON MW3 

Explanation: An erroneous EOF occurred on the modifi- 
cation tape during an EDIT run while SG5 was search- 
ing for a module. 

Corrective Action: Check the EDIT control cards, cor- 
rect, and rerun the job. 

11559 CONTROL CARD ERROR 

Explanation: A parameter on a control card has been 

entered incorrectly. 

Corrective Action: Correct the card and rerun the job. 

11559 ERRONEOUS EOF ON MW2 

Explanation: During an EDIT pass or Disk SG5 run an 
EOF was sensed on MW2. 

Corrective Action: Assign a larger portion of disk storage 
to MW2. 

11559 TLIB CARD INVALID ON DISK SYSTEM 

Explanation: No TLIB control card can be used for the 

Disk System. 

Corrective Action: Correct the deck and rerun the job. 

11559 UNCORRECTABLE I/O ERROR ON SYS DISK 

Explanation: An uncorrectable I/O error occurred on a 
system file (SOF or LIB). 

Corrective Action: Reload the system on disk and rerun 
the job. 

11559 IMPROPER PARAMETER ON EXEQ CARD 

Explanation: A parameter on an EXEQ card has been 

specified incorrectly. 

Corrective Action: Correct the card and rerun the job. 

11559 IMPROPER USE OF DMIN PARAMETER 

Explanation: The DMIN parameter has been, used in- 
correctly. 
Corrective Action: Correct the card and rerun the job. 

11559 INCOMPLETE ASSIGNMENTS CHECK DECK - 

RERUN 

Explanation: One or more assignments have been 

omitted. 

Co.rrective Action: Correct the deck and rerun the job. 

11559 OMIT CARD IN ERROR - CORRECT AND RERUN 
Explanation: There is an error in an OMIT card. 
Corrective Action: Correct the card and rerun the job. 
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11559 OMIT MODULE NOT IN DIRECTORY 

Explanation: SG5 did not find a module specified for 
omission. 

Corrective Action: Check the deck against the modifica- 
tion tape listing, correct the card, and rerun the job. 

11559 JOB CARD MISSING - CORRECT AND RERUN 
Explanation: A JOB card has been omitted. 
Corrective Action: Insert the correct JOB card into the 
deck and rerun the job. 

11559 NO MDM IN SYSTEM - CORRECT AND RERUN 
Explanation: An ASGN MDM card has been read; how- 
ever, there are no MDM facilities in the system. 
Corrective Action: Remove the ASGN MDM card and 
rerun the job. 

11559 INVALID ASGN CARD - CORRECT AND RERUN 

Explanation: An invalid ASGN card was included in the 

deck. 

Corrective Action: Correct the card and rerun the job. 
11559 NO ASGN CARDS - CORRECT AND RERUN 

Explanation: The ASGN cards were omitted from the 

control deck. 



Corrective Action: 
and rerun the job. 



Insert the ASGN cards into the deck 



11559 UNCORRECTABLE ERROR ON INPUT TAPE 
Explanation: The input tape has a read error. 
Corrective Action: Rerun the job with a new modification 
tape. 

In addition to the diagnostic messages, the following 
console typewriter messages may appear: 

11558 REPLACE MW3 WITH SCRATCH TAPE - ENTER 

$50 

Explanation: This message appears when the DMIN pa- 
rameter is used on the Monitor EXEQ control card. It 
indicates that the program is ready for the scratch tape 
to be mounted. 

Corrective Action: Replace the modification tape with a 
scratch tape and enter $50 to discontinue the wait loop. 

11560 UPDATE SIU ON MWl 

Explanation: This message indicates end of job and gives 
the location of the new SIU. 
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Appendix A: Maintaining the History File with 
the SG3 Program 

The History file, supplied by ibm as an optional item, 
contains all of the Autocoder statements ( in the form 
of blocked-record symbolic program decks ) that make 
up the programs and modules contained on the Master 
file. The sg3 program is used to maintain the History 
file. 

The SG3 program is executed in a standard job run. 
It cannot be run during System Generation. 

A user can obtain a new History file with sg3 by: 

1. Placing new subprograms (in the form of Auto- 
coder, FORTRAN, or COBOL Symbolic decks) onto the 
History file. 

2. Updating an old History file by inserting and de- 
leting individual symbolic statements. 

3. Copying or merging information from one or 
more History files. The new History file is produced by 
a combination of copying and updating or by merging 
several old History files. 

Note: A file of compiler input statements also can 
be produced when the new History file is being cre- 
ated. This file serves as input for the appropriate 
(Autocoder, Fortran, or cobol) processor for an as- 
sembly or compilation of the updated file. Only one 
FORTRAN or COBOL sourcc program can be placed on 
the compiler input file; any number (limited only by 
the physical capacity of the file) of Autocoder source 
programs may be placed on the file. 

Additional features, such as the listing and/or 
punching of the new History file, are discussed under 
"Control Cards." 

Program Input and Output Requirements 

The input/output assignments and input/output for- 
mats associated with the sob program are indicated 
below. 

Input Units 

1. Control cards, cards for new subprograms to be 
added to the History file, and cards for updating sub- 
programs already on the History file are placed on the 
sru. 

2. The old History file is assumed to be on work file 
MW4. If the user desires, the old History file may be 
placed on another work file (Mwn), or on a reserve 
file ( MRn ) , specified for his system at System Genera- 
tion time. The optional file is specified on the control 
card for the subprogram being copied or updated. 



Note: Work files mw5 and/or mw6 may be re- 
quired for output as explained below. 

Input Format 

1. Monitor control cards are in the format standard 
for the Operating System. sg3 control cards are in the 
format described under "Control Cards." Cards for 
new subprograms, or updating cards for existing sub- 
programs, are in the input format defined for the ap- 
plicable symbolic language. 

2. The old History file is blocked, 25 card images 
per physical record. 

Output Units 

1. A new History file, if specified, is always pro- 
duced on work file mws. No other work or reserve file 
may be substituted for mw5. 

2. The compiler input file, if specified, is always pro- 
duced on work file mw6. No other work or reserve file 
may be substituted for mw6. 

Output Format 

1. The new History file is blocked, 25 card images 
per physical record. 

2. The compiler input file consists of (unblocked) 
card-image records. 

Machine Configuration Requirements 

SG3 requires: (1) the sof plus a minimum of two addi- 
tional tape units, a card reader, and the Standard Print 
Unit, or ( 2 ) the sof plus a minimum of four additional 
tape units. The minimum configuration has the follow- 
ing r-estrictions: 

1. Two runs are required if both a new History file 
and a compiler input file are desired. The first run up- 
dates the old History file. The second run creates the 
compiler input file. With an additional work file, these 
two functions may be performed in one run. 

2. Merging of History files cannot be performed 
with the minimum configuration. An additional work 
file is required for each file to be merged with the 
old History file. 

Note: The Standard Punch Unit is required if the 
user elects to punch his new History file. 

Control Cards 

Four types of control cards may be directed to the 
SG3 program: 
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1. COPY, to copy one or more subprograms from an 
old History file onto the new History file. 

2. UPDATE, to add new subprograms to, or change 
subprograms already on, an old History file. In either 
case, a new History file is produced. To update a sub- 
program that appears on an old History file, the updat 
card must be followed by groups of cards, each group 
consisting of an Insert/Delete control card followed 
by source cards (if any) that are to be inserted. The 
UPDAT card also contains the specifications for the sev- 
eral SG3 options, e.g., printing the new History file. 

3. Insert/Delete, to insert symbolic cards into, or 
delete symbolic cards from, the subprogram specified 
by the immediately preceding updat card. 

Note: Insertion or deletion of symbolic cards in or 
from a Fortran source program is made on the basis 
of pseudo sequence numbers of the cards in the source 
program. Pseudo sequence numbers are necessary be- 
cause there is no provision in the Fortran language to 
assign a sequence, page-and-line, or similar number to 
a source card. To enable updating a Fortran program, 
the user must first place the program on the History 
file by using the updat card siu option, and request a 
listing of that program by placing an l in column 10 
of the UPDAT card. The listing thus obtained for the 
FORTRAN program placed on the History file will con- 
tain a pseudo sequence number for each card in the 
FORTRAN program; these numbers never appear in rec- 
ords on the History (or any other) file; they are 
printed only on the listing. When updating a Fortran 
program, sg3 maintains a count of cards read, thereby 
simulating the pseudo sequence numbers that appear 
on the listing. Because updating a Fortran program 
may alter the pseudo sequence numbers assigned, the 
user should specify that the updated Fortran pro- 
gram be listed so that he can have the new set of 
pseudo sequence numbers available for future up- 
dating. 

4. Comment, to place descriptive information onto 
the SPR during execution of SG3. 

The following control card discussions refer to se- 
quence numbers and revision letters. 

Sequence Number: This is a card sequence number 
of five characters from OOOIA through 99989 that is 
placed in columns 1 through 5 of the output records 
produced by sg3. When the History file is updated, 
new sequence numbers are assigned unless the user 
elects otherwise (column 9, updat card). 

Revision Letter: This is a single-character code (A 
through Z) that indicates the level of modification of 
each subprogram on the History file. The code is car- 
ried in the header record produced by sg3 for each pro- 
gram on the History file. The code is placed in a com- 



ment card when the user specifies that the program be 
placed on the compiler input file. The code also ap- 
pears in the table of contents produced by sg3 when a 
new History file is created. The revision letter may be 
used to ensure that updates are performed sequen- 
tially. The user may specify in columns 4 and 5 of the 
UPDAT card that the revision letter on the old History 
file be compared to the revision letter he provides in 
the UPDAT card, that the revision letter be reset to a, 
etc. The revision letter is usually advanced by one 
letter ( e.g., a to b, b to c, y to z, z to a, etc. ) each time 
a program is updated. However, this alteration of the 
revision letter may be overridden by specifications in 
columns 4 and 5 of the updat card. 

Note: Version 3 and later versions of the Operating 
System contain a revised sg3 program. When using the 
new SG3 program to update for the first time any pro- 
gram placed onto the History file by the old SG3 pro- 
gram, the user must give careful attention to coding 
the sequence numbers on which updating is based. 
The sequence numbers coded for the first update must 
exactly match those contained on the old History file; 
these numbers must include the revision letter ap- 
pended to the four-digit sequence numbers by the old 
SG3 program. During the first update run, the new sg3 
program resequences the cards in the program and 
eliminates the revision letter. The new sg3 program 
allows a five-character sequence number that excludes 
the revision letter. In the new sg3 program, the revi- 
sion letter is carried in the program header record 
instead of being appended to each sequence number. 



Copy Card 

CARD 
COLUMN 



1 
2-5 
6-8 



9 
10 



11 



12 



CONTENTS EXPLANATION 

$ Indicates SG3 control card. 

Blank Not used. 
MWn or Location of the old History file; may be 
MRn any unit specified for the system at Sys- 

tem Generation time. 
Blank If blank, SG3 assumes the old History 
file to be on MW4. 

Blank Not used. 

L The subprograms being copied from 

the old History file are to be printed on 
the Standard Print Unit. 
Blank No printing. 

P The subprograms being copied from the 

old History file are to be punched on 
the Standard Punch Unit. 
Blank No punching. 

H The subprograms are to be copied from 

the old History file (location specified 
in columns 6-8) onto the new History 
file on MW5. 
Blank If there are any entries in columns 6-15, 
the old History file is not copied onto 
a new History file. If columns 6-15 are 
blank, the subprograms on the new 
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CARD 
COLUMN CONTENTS 



13-15 

16-20 
21-75 



Blank 
COPY 

name 



76-80 



namel, 
name2 



Blank 



Updat Card 

CARD 
COLUMN CONTENTS 

1 $ 

2,3 Blank 

4.5 $$ 

Blank $ 
Blank X 



*X 



6-8 



MWn or 
MRn 

Blank 

SIU 



EXPLANATION 

History file on MW5 are automatically 
copied from the old History file on 
MW4. There is no printing or punching. 

Not used. 
Type of card. 

This is the name of the subprogram 
being copied with the options specified 
in columns 6-12. In the case of subpro- 
grams previously added to the History 
file by means of the UPDAT card SIU 
option, name is the entry beginning in 
column 21 of that card. 
This entry (comma required) causes 
subprograms namel through and in- 
cluding name2 to be copied from the 
old History file onto the new. 

Not used. 



EXPLANATION 

Indicates SG3 control card. 
Not used. 

If there is a $ in column 4 and in col- 
umn 5, the revision letter for this pro- 
gram is set to A. 

If column 4 is blank and column 5 con- 
tains a $, the revision letter is not 
checked, but is advanced by one letter. 
X is any alphabetic character. If column 

4 contains a blank and column 5 con- 
tains any alphabetic character, that 
alphabetic character is compared to the 
revision letter in the header record for 
this program. If the alphabetic char- 
acter is equal to the revision letter, the 
updating proceeds normally, and the re- 
vision letter is advanced by one letter. 
If the alphabetic character is not equal 
to the revision letter, the job is ter- 
minated, and the revision letter is not 
altered. 

If column 4 contains an * and column 

5 contains a $, the revision letter is 
neither checked nor advanced. 

X is any alphabetic character. If column 
4 contains an * and column 5 contains 
any alphabetic character, the alphabetic 
character is compared to the revision 
letter in the header record for this pro- 
gram. If the alphabetic character is 
equal to the revision letter, the updating 
proceeds normally, but the revision 
letter is not advanced. If the alphabetic 
character is not equal to the revision 
letter, the job is terminated, and the re- 
vision letter is not altered. 

Location of the old History file; may be 
any work or reserve unit specified for 
the system at System Generation time. 
If blank, SG3 assumes the old History 
file to be on MW4. 

This entry indicates that a new subpro- 
gram is to be added to the History file. 
The cards containing the source state- 
ments follow the UPDAT card in the 
SIU. 



CARD 
COLUMN 



10 



11 



12 



13 



14 



CONTENTS EXPLANATION 

N New sequence numbers are not assigned 

for statements on the new History file. 
Blank New sequence numbers are to be as- 
signed for statements on the new His- 
tory file. 

L This subprogram on the new History 

file is to be printed on the Standard 
Print Unit. 
Blank No printing. 

P This subprogram on the new History 

file is to be punched on the Standard 
Punch Unit. 
Blank No punching. 

H The subprogram named beginning in 

column 21 of this card is to be written 
onto the new History file on symbolic 
unit MW5. 
Blank No History file is to be written if there 
is any entry in columns 6-15. If columns 
6-15 are all blank, the subprogram is to 
be written on both the compiler input 
file and the new History file. 

A Write card-image records to form Auto- 

coder input file on MW6 for later as- 
sembly. 

F Write card-image records to form FOR- 

TRAN input file for later compilation. 

C Write card-image records to form 

COBOL input file for later compilation. 
Blank No compiler input file is produced. 

1-7 If column 13 contains an A, the SG3 

program produces an EXEQ AUTO- 
CODER card-image record for each 
UPDAT card processed. This card speci- 
fies the options for the Autocoder as- 
sembly of the subprogram named in col- 
umns 21-30. All options for this card, 
except the NOFLG option, are specified 
by the entry in column 14. The column 
14 options for the (SG3-produced) 
EXEQ AUTOCODER card follow and 
are explained in the publication IBM 
1410/7010 Operating System; System 
Monitor, Form C28-0319. 
1-NOPRT 
2-NOPCH 
3-NOPRT,NOPCH 
4-NOMAC 
5-NOPRT,NOMAC 
6-NOPCH,NOMAC 
7-NOPRT,NOMAC,NOPCH 

Note: SG3 produces no EXEQ card 
for the first UPDAT card (and the up- 
dating cards associated with it) proc- 
essed. Options for the assembly of a 
single subprogram, or the first of two 
or more subprograms, are specified on 
the MON$$ EXEQ AUTOCODER card 
provided by the user. This card must 
follow the last UPDAT card, with its 
related updating cards, in the SIU. 
Blank No Autocoder options. 
F Indicates to SG3 that a FORTRAN His- 

tory file is being maintained. 
C Indicates to SG3 that a COBOL History 

file is being maintained. 
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CARD 




COLUMN 


CONTENTS 


15 


N 



Blank 



EXPLANATION 

If an A is specified in column 13, an 
N in this column indicates the NOFLG 
option when this subprogram named 
beginning in column 21 is later assem- 
bled in accordance with the SG3-pro- 
duced EXEQ card (refer to column 14 
explanation ) . 
No option. 



CARD 
COLUMN CONTENTS 



16-20 UPDAT Type of card. 



21-75 



This is the name of the subprogram be- 
ing updated with the options specified 
in columns 4 through 13. The name 
must be left-justified in column 21 and 
must not exceed ten alphameric char- 
acters. The first character of name must 
be an alphabetic character. 
If columns 6-8 contain "SIU," the name 
is placed on the History file to identify 
the subprogram that is being added. 
This name is used for all subsequent 
COPY and UPDAT cards to identify the 
subprogram. 



73-80 



Not 

or Blank 

76-80t 



The contents of these columns are 
placed into the Identification field ( col- 
umns 73-80 or 76-80) of the History 
file and/or compiler input file for each 
card in the subprogram. 
Blank The Identification field of the subpro- 
gram is carried imchanged. 
fColumns 73-80 for FORTRAN or COBOL; columns 76-80 for 
Autocoder. 



Insert /Delete Card 

Insert/Delete cards pertain to the subprogram desig- 
nated on the last preceding updat card. An Insert/ 
Delete card directs sg3 to insert the immediately fol- 
lowing symbolic cards into (or delete symbolic cards 
from) the subprogram specified on the updat card. 
The point at which the insertion or deletion is to be 
made is specified on the Insert/Delete card. ( A request 
to delete a nonexistent card causes the next symbolic 
card to be deleted. ) 



CARD 
COLUMN CONTENTS 



1 

2-12 



xxxxx 



xxxxx, 

YYYYY 



EXPLANATION 

Indicates SG3 control card. 
The symbolic cards that follow this con- 
trol card are to be inserted into the sub- 
program named on the last preceding 
UPDAT card. Within the subprogram, 
the insertion is to be made immediately 
following the subprogram card identified 
by sequence number XXXXX. This se- 
quence number is a one- to five-digit 
number, written free form, left-justified 
(e.g., 829 or 2932). 

The cards with sequence numbers from 
XXXXX through YYYYY are deleted 
from the subprogram named in the last 
preceding UPDAT card and replaced 
by the symbolic cards (if any) that fol- 
low this control card. The sequence 
number is a one- to five-digit number 



Comments Card 


CARD 




COLUMN 


CONTENTS 


1 

2-5 

6 

7-80 


$ 

Blank 

ft 

comments 



EXPLANATION 

written free form, left-justified. The 
sequence numbers XXXXX and YYYYY 
must be separated by a comma. 
13-80 Blank Not used. 

Example 1: $25 beginning in column 1 means: In- 
sert the symbolic cards following this control card into 
the output file(s) behind the card with sequence num- 
ber 00025. 

Example 2: $4310A,43769 beginning, in column 1 
means: Delete cards with sequence numbers 4310A 
through 43769 and insert the symbolic cards following 
this control card in place of the deleted cards on the 
output file(s). 



EXPLANATION 

Indicates SG3 control card. 
Not used. 

Indicates Comments card. 
The contents of this field are printed 
on the Standard Print Unit when en- 
countered during execution of the 
SG3 program. 



SG3 Execute Record 

The Monitor exeq control card required to execute sg3 
is in the format that is standard for the Operating 
System: 

6 16 21 

MON$$ EXEQ SG3,P2,P3 

where the second and third parameters (P2 and P3) 
are described in the System Monitor publication. If 
this format of the exeq card is used, the user must in- 
clude UPDAT, COPY, and Insert/Delete cards to direct 
the SG3 program, and Comments cards to place com- 
ments onto the spr. 

SG3 permits a fourth exeq card parameter, copy. The 
format of an exeq card containing this fourth param- 
eter (and omitting the second and third parameters) 
is: 

6 16 21 

MON$$ EXEQ SG3„,COPY 

The COPY parameter on the exeq card may be used 
to cause copying of an entire History file when no up- 
dating is to be performed. If only the copy function is 
desired, no additional control cards are required. The 
History file to be copied is assumed to be on work file 
MW4; the new History file is written on work file MWf). 
Because of the absence of additional control cards, no 
SG3 options (e.g., writing a compiler input file) are 
available. 

With certain restrictions, the copy parameter may 
also be used on the exeq card which initiates sg3 proc- 



84 



essing for a run during which updating is to be per- 
formed. The appropriate updat, Insert/Delete, and 
Comments control cards must follow the exeq card. 
No COPY control cards are required, because the copy 
parameter in the exeq card causes copying of all sub- 
programs not updated from the old History file to the 
new. 

The following restrictions apply to the use of the 
COPY parameter on the exeq card for an sg3 run during 
which updating is to be performed. 

1. Only a single History file may be updated and 
copied; that History file must be on work file mw4. 

2. No UPDAT control card with the siu parameter is 
permissible; i.e., no new subprograms may be added 
to the History file. 

3. COPY control cards cannot be used. 

Example 

Figure 35 illustrates the use of sg3 control cards to in- 
clude a new subprogram on the new History file, to 
update a subprogram on the old History file, and to 
copy a subprogram from the old History file to the 
new History file. Monitor and Linkage Loader control 
cards are also shown; they specify assembly (assum- 
ing Autocoder subprograms) of two of the subpro- 
grams handled by sg3, and execution of one of the 
two programs assembled. Following is a brief explana- 
tion of the control cards. 

The first packet of control cards (job through exeq) 
assigns a name to the job, declares mode go, assigns 
required input/output units, and causes execution of 
SG3. The first updat card causes sg3 to: 

1. Read a new subprogram, samplei, from the siu. 

2. Place SAMPLEI on the new History file on mw5. 

3. Place SAMPLEI, an Autocoder subprogram, on the 
compiler input file on mw6. 



4. List SAMPLEI on the spr, and punch it on the spu. 
The second updat card causes sg3 to: 

1. Update SAMPLE2, a subprogram on the old His- 
tory file on MW4, and place the updated version of 
SAMPLES on the new History file following samplei. 

2. Place SAMPLE2, an Autocoder subprogram, on the 
compiler input file following samplei. 

Insert/Delete cards $24 and $35,46 indicate where 
the modifications in samples are to be made. Updat- 
ing symbolic cards are placed in the siu as indicated 
by the comment cards in the example. 

The copy card causes samples to be copied from 
MW4 to MW5, the new History file. 

The exeq autocoder card causes samplei and sam- 
ples to be assembled from the compiler input file 
( mw6 ) and placed on the Go file. 

The exeq linkload card and the following two 
cards cause samples to be placed onto the Job file. 

The exeq programa card causes samples to be exe- 
cuted from the Job file. 



Trailer Label for History File 

A standard 120-character trailer label is added to the 

end of each new History file created by sg3. The trailer 

is in the following format: 

Ieor (positions 1 through 4 of the record) 

nnnnnn ( block count in position 67 through 72 of record ) 

Heading for Listing Page 

The following header is placed on a listing of a new 
History file produced by SG3: 

where xxxxx is the date in year-day format, and nnn is 

DATE , . . xxxxx *****SG3 LIST ***** PAGE ... nnn 
the page number. 



MON»S JOB HISTFILE 
•*« MONITOR ASSIGNMENT CARDS ••« 



ASGN MJB.Al 

ASGN MG0«B2 

ASGN MN4.A6 

ASGN MN5*A2 

ASGN MW6»A3 

MODE GO 

COMT BOILO HISTORY FILE CONSISTING OF SAMPLEI FROM SIU 

COMT AND SAMPLE2 + SAMPLES FROK EXISTING HISTORY FILE. 



MON«S 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 

MONSS EXEQ SG3 
SSSIU LPHA UPDATSAMPLEl 

(INSERT SYMBOLIC CARDS FOR HISTORY FILE.) 
» UPDATSAMPLH2 

(SYMBOLIC CARDS TO BE INSERTED FOLLOWING CARD 24 
OF SAMPLE2 ARE PLACED HERE.) 
5. 46 

(DELETE CARDS 35 THROUGH 46. 
SYMBOLIC CARDS TO BE INSERTED BEFORE CARD 47 
OF SAMPLE2 ARE PLACED HERE.) 
COPY SAMPLES 
MONSS COMT EXECUTE AUTOCODER TO COMPILE SAMPLEI 
MONSS EXEQ AUTOCODER,, IWW6 

MONSS COMT EXECUTE LINKLOAD TO BUILD A JCB FILE 
MONSS EXEQ LINKLOAD 
PHASEPROGRAMA 
CALL SAMPLE2 
MONSS COMT EXECUTE PROGRAMA 
MONSS EXEQ PROGRAMA, MJB 



♦ SAMPLE2 



»•» DATA CARDS - OPTIONAL •»• 



NEXT JOB 



MONSS 
MONSS 



END 
JOB 



OR 



Figure 35. Control Cards for Sample Job Using sg3 
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SG3 Diagnostic Messages 

SG3 may produce several diagnostic messages, which 
are placed on the console typewriter and/or the spr. 
These messages, grouped according to the unit(s) on 
which they appear, are explained below. 

Console Typewriter and SPR 

The following messages appear on both the console 
typewriter and the spr. Message text alone is typed on 
the console typewriter; both message text and the con- 
tents of the erroneous card are placed on the spr. Ac- 
tions to be taken are indicated at the end of the ex- 
planations of the messages. For details on the "Console 
Inquiry" action, see "On Console Typewriter Only." 

11540 DIAGNOSTIC END 01 

Explanation: Designation of work/reserve file for History 
file residence is invalid. Only Monitor work/reserve flies 
incorporated into the system at System Generation time 
are valid. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 02 

Explanation: Revision letter specified in control card does 
not match that in header for subprogram. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 03 

Explanation: Subprogram requested is not on History file. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 04 

Explanation: No $ in column 1 of control card. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 05 

Explanation: Card should be COPY or UPDAT card. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 06 

Explanation: Column 13 of UPDAT card contains invalid 
character. Valid characters are : F, C, A, and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 07 

Explanation: Column 12 of UPDAT card contains invalid 
character. Valid characters are: H and blank. 
Action: Correct card and rervm job. 

11540 DIAGNOSTIC END 08 

Explanation: Column 11 of UPDAT card contains invalid 
character. VaUd characters are: P and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 09 

Explanation: Column 10 of UPDAT card contains invalid 
character. Valid characters are L and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 11 

Explanation: Control card contains no subprogram name. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 12 

Explanation: Sequence number in last card read is in 

error. 

Action: Correct card and rerun job. 



On Console Typewriter Only 

One message, directed to the operator and requesting 
a console inquiry for a 11540 diagnostic end nn mes- 



sage, is typed only on the console typewriter. That 
message is: 

11541 ENTER $3P or $3S 

The $3P response will cause the erroneous card to be 
ignored, and the run to proceed normally. 

The S3S response will cause processing to be termi- 
nated, and the remaining control cards to be checked. 
Errors found in checking control cards after process- 
ing is terminated are indicated by diagnostic messages 
and discussed in the following section. 

On SPR Only 

The following messages are put onto the spr only. 
Messages 11542 through 11545 may be produced dur- 
ing the normal processing of sea. Message 11546 is pro- 
duced only when checking control cards after termina- 
tion of normal sg3 processing. The contents of the er- 
roneous cards follow the 11546 messages. 



11542 UNCORRECTABLE 
I/O ERROR ON 
OLD HISTORY 

11542 UNCORRECTABLE 

I/O ERROR ON NEW 
HISTORY 

11542 UNCORRECTABLE 
I/O ERROR ON SIU 
INPUT RECORD 

11543 THIS RUN HAS BEEN 
DIAGNOSTICALLY 
TERMINATED. THE 
LAST FILE IS 
POSSIBLY 
ERRONEOUS. 

11544 400 PROGRAM 
CAPACITY OF FILE 
HEADER TABLE HAS 
BEEN EXCEEDED. 

11545 UNEXPECTED END 
OF FILE ON MWx. 



11546 '*** ERROR 01 
IN FORMAT 
OF CARD 

11546 **** ERROR 02 
IN FORMAT 
OF CARD 

11546 **** ERROR 03 
IN FORMAT 
OF CARD 

11546 "**' ERROR 04 
IN FORMAT 
OF CARD 

11546 '*** ERROR 05 

IN FORMAT 
OF CARD 



EXPLANATION 

SG3 is unable to read the old 
History file; the run is ter- 
minated. 

SG3 is unable to read the 
new History file; the run is 
terminated. 

SG3 is unable to read the 
Standard Input Unit; the run 
is terminated. 

The run has been terminated. 
The last subprogram on new 
History file may be invalid. 



Capacity of History file 
(400 subprograms) ex- 
ceeded; the run is terminated. 

Unexpected end-of-file con- 
dition on MW5 or MW6. 
The capacity of the new His- 
tory file or the compiler in- 
put file is exceeded; the run 
is terminated. 

Sequence field of last card 
read is in error. 

Column 13 of UPDAT card 

contains invalid character. 

Valid characters are: A, F, 

C, and blank. 

Column 12 of UPDAT card 

contains invalid character. 

Valid characters are: H and 

blank. 

Column 11 of UPDAT card 

contains invalid character. 

Valid characters are; P and 

blank. 

Column 10 of UPDAT card 

contains invalid character. 

Valid characters are: L and 

blank. 



MESSAGE 

11546 ***** ERROR 06 
IN FORMAT 
OF CARD 



EXPLANATION 

Designation of work/reserve 
file (in columns 6-8 of UP- 
DAT or COPY card) for 
History file residence is in- 
valid. Only those Monitor 
work/reserve files incorpo- 
rated into the system at Sys- 
tem Generation time are 
valid. 



Appendix B: Operating Systent Core-Storage 
Requirements 

The values below provide guidelines to estimate the 
core-storage requirements for an Operating System. 
The figures are subject to change as modifications are 
made to the system. (New figures will be published 
should a change of more than ten percent occur. ) 



Resident Monitor Requirements 



Basic Resident Monitor 

Noi'E: These figures include all in- 
dex registers (and floating-point 
areas ) . 
Completely tape-oriented, 1-channel 

IOCS 
Completely 1301/2302 disk-oriented, 1- 
channel IOCS 

Note: The disk-oriented Monitor 
includes the 1301/2302 disk IOCS 
routines. 
Tape-oriented with 1301/2302 disk ca- 
pabilities, 1-channel IOCS 
Additional 1301/2302 disk IOCS chan- 
nels 
Additional 1301 disk IOCS channels 
Optional System Functions 
Standard Print Unit 
Unit-record 

Note; When the Standard Print 
Unit and/or Standard Punch Unit 
are specified as unit-record equip- 
ment, the IOCS unit-record routine 
must be included. If an IBM 1442 
Card Reader is specified at System 
Generation, an additional 24 posi- 
tions of core storage are needed. 
Tape Unit 

Note: The following file assign- 
ment core-storage sizes must be 
added where applicable: 
Each symbolic unit— 5 
Each unit-record device— 9 
Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied) -9 
Each disk area— 20 
Variable unit 
Standard Punch Unit 
Unit-record 



core- 
storage 
locations 
required 



7,825 

11,660 



9,340 

600 each 
350 each 



280 



260 



320 
240 



Note: When the Standard Print 
Unit and/or Standard Punch Unit 
are specified as unit-record equip- 
ment, the IOCS unit-record routine 
must be included. If an IBM 1442 
Card Reader is specified at System 
Generation, an additional 24 posi- 
tions of core storage are needed. 
Tape unit 

Note: The following file assignment 
core-storage sizes must be added 
where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied) -9 
Each disk area— 20 
Variable unit 
Core-Image file capability 

Note: The following file assignment 
core-storage sizes must be added 
where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied) -9 
Each disk area— 20 
Note: When MDM (Core Image 
file)* is specified, IOCS Checkpoint 
routine must be included. 
Labeled system files (80 or 120 char- 
acters ) 

Note: When labeled system files are 
specified, the corresponding (80- or 
120-character ) IOCS label routine 
must be included. 
Alternate Input Unit (AIU) capability 
Snapshot 

Note: Because Snapshot begins at 
an even-hundred core-storage loca- 
tion, up to 99 additional core-storage 
positions may be required. 

Optional IOCS Routines 

Unit-record 

Note: When the Standard Print 
and/or Standard Punch Unit are 
specified as unit-record equipment, 
the IOCS unit-record routine must 
be included. If an IBM 1442 Card 
Reader is specified at System Gen- 
eration, an additional 24 positions 
of core storage are needed. 

80-character tape labels 

Note: When labeled system files are 
specified, the corresponding (80- or 
120-character) IOCS label routines 
must be included. 

120-character tape labels 

Note: When labeled system files 
are specified, the corresponding (80- 
or 120-character) IOCS label rou- 
tine must be included. 

Label exit routine 

Tape error statistics 



core- 
storage 
locations 
required 



260 



270 
50 



40 



150 

2,000 



250 



1,225 



1,445 



350 

575 
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Implementation of user-written service 

routines 

Checkpoint, IBM 7330 Tape Units not 

specified 

Note: When MDM (Core Image 

file) is specified, IOCS Checkpoint 

routine must be included. 
Checkpoint, IBM 7330 Tape Units 
specified 

Note: When MDM (Core Image 

file) is specified, IOCS Checkpoint 

routine must be included. 
Shared Disk 

Type A Generation 

First channel 

Each additional channel 
Type B Generation 

First channel 

Each additional channel 
Type C Generation 

First channel 

Each additional channel 
Type D Generation 

First channel 

Each additional channel 



CORE-STORAGE 
LOCATIONS REQUIRED 

445 
410 



460 



300 
240 

250 
190 

90 
90 

350 
270 



Optional Resident Monitor Requirements for TP 

Extension of IOCS 

One of the following Supervisors: 

No dump and restore capability 

Tape dump and restore capability 
(TPTAPEDUMP) 

Disk dump and restore capability 
(TPDISKDUMP) 

Tele-processing only 

TPBASSUPER 
"Start" and "end" modules, 1-channel TP 
Additional "start" and "end" modules for 

the second TP channel 
For device indicated: 

Programmed Transmission Control 



IBM 1050 Data Communications 
System 

IBM 1414, Model IV or V with IBM 
1009 Data Transmission Unit 

IBM 1414, Model IV or V with IBM 
1014 Remote Inquiry Unit 

IBM 1414, Model IV or V with 
Telegraph Terminal Unit 

One of the following load programs: 
Absolute tape loader 
Absolute 1301 disk loader 
Relocatable tape loader 
Relocatable 1301 disk loader 



1,650 

3,400 
1,303 

1,440 

3,470 

4,400 

58 

58 

2,770 per 

channel 

1,400 per 

adapter 

2,090 per 

adapter 

1,250 per 

adapter 

1,170 per 

adapter 

4,400 
6,110 
6,580 
6,320 



Note: TP Directory requires 20 positions of core storage for 
each memory map entry and 14 positions for each directory 
entry. 

Optional Resident Monitor Requirements for SPOOL 

Type I SPOOL 

Using IBM 1402 Card Read Punch only 950 per 

(CRD) channel 

Using IBM 1402 Card Read Punch and 1,225 per 

IBM 1403 Printer channel 

(ALL) 



core-storage 
locations required 

Type II SPOOL 1,300 per 

channel 
Type III SPOOL 3,200 for 

channel 
1,250 for second 
channel 
Note: The stated figures do not include the number of posi- 
tions that are required for a user-written editing routine. The 
Type II SPOOL figure should be used for both Type II and 
Type III SPOOL in a tp system. 

Basic Resident Monitor Requirements for 1311 Disk 

AJODTTIOSAL 
CORE-STORAGE LOCATIONS 
SEQUENTIAL 

AND NONSEQUENTIAL 

NONSEQUENTIAL ONLY 



( NO 6th IOKDF 
OPERAND ) 

First channel with 1311, Resident 
Monitor with tape-processing 
facilities only 2,800 

First channel with 1311, Resident 
Monitor with tape and 1301/ 
2302 processing facilities 2,350 

Second channel with 1311 750 

Optional 1311 Label Routines 

100-character disk label routines, if 
120-character tape label routines 
have not been included in Resi- 
dent Monitor 900 

100-character disk label routines, if 
120-character tape label routines 
have been included in Resident 
Monitor 350 

1311 label exit routines, if tape 
label exit routines have not been 
included in Resident Monitor 300 

1311 label exit routines, if tape 
label exit routines have been in- 
cluded in Resident Monitor 50 



( 6th iokdf 
operand) 



1,600 



1,300 
750 



Nonresident Requirements 



core-storage 
locations required 



TAPE 

oriented 



disk 
oriented 



Compilers 
Autocoder 19,000 20,050 

Note: All remaining available core 
storage is used by Autocoder as 
follows: 70% for label table; 30% for 
literal table. 
COBOL 28,500 38,950 

Note: All remaining available core 
storage is used by COBOL for tables. 
FORTRAN 26,550 35,550 

Note: All remaining available core 
storage is used by FORTRAN for 
tables. 
File Organization System 

System Definition 5,000 

File Organization 4,000 to 43,300 

( min. UNLOAD ) ( max. ADD ) 
Extended IOCS Modules 7,000 to 10,150 

Note: Each file table relating to an organized file includes a 
270 position file table prefix in addition to the standard file 
table of 45 to 57 positions. 





CORE-STORAGE 




LOCATIONS REQUn 


Utility Programs 




Snapshot 


2,000 


Storage Print 


8,000 


Tape Print 


7,000 


Disk Print (1301,2302, 1311) 


11,100 


1301 Format/ Address Generator 


14,000 


2302 Format/Address Generator 


13,000 


File Save program 


20,000 


File Restore program 


18,500 


Data File Generator 


19,400 


1311 Format/ Address Generator 


8,500 


1311 Disk Label Program 


7,500 


Random-Processing Scheduler 




Basic 


3,300 


DEFSA macro 


180 


MVRSA macro 


250 


PUT macro 


375 


FSEQP macro 


850 


Output only 


180 


Each 1301 disk module 


13 


Additional Tele-processing Programs 




TPATLIBGEN 


17,140 


LINKLOADRT 


20,500 


TPADLIBGEN 


14,840 


LINKLOADRD 


22,800 


TPLDDCPl 


500 


TPLDDCP2 


500 


1311 Scan Feature 


450 


1311 Cylinder overflow routines 


500 


Linkage Loader 




Tape 


25,600 


1301/2302 Disk Storage 


30,200 


System Generation, Tape or 1301/2302 




Disk Storage 


27,000 


Transitional Monitor 




Tape-oriented system 


13,340 


Disk-oriented system 


15,250 


POWTRAN 


1,500 


Core Image file capability 


670 


Restart 




1-channel IOCS 


3,500 



Note: When Restart is desired, IOCS Checkpoint routine must 

be specified. 

Additional IOCS channels 600 each 

Depending upon inclusion of 
some or all optional system 
functions ( excluding Snap- 
shot) 25 to 625 

Note: The following file assignment core-storage sizes must be 

added where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified)— 14 

Each tape unit (MDM not specified)— 9 

Each disk area-20 



Appendix C: IOCS Timing Estimates 

Timing estimates for the iocs can be made from the 
following information. These timings do not take into 
account exceptional conditions (e.g., busy and not 
ready conditions) on the i/o devices. 



SCHEDULING FUNCTIONS 
( NOTE 1 ) 

1. Blocking/unblocking of GET or 
PUT, time per record ( Note 2 ) : 



TIMING IN microseconds 
IBM 1410 IBM 7010 



2. 



SCHEDULING FUNCTIONS 


TIMING IN ]V 


tICROSECONDS 


(note 1) 


IBM 1410 


IBM 7010 


a. GET or PUT, Form 2 data 






records 


370 


130 


b. GET, Form 4 data records 


370 


130 


c. PUT, Form 4 data records 


595 


210 


GET FILE: 






a. One lORW is sent to a read/ 






write list; file consists of un- 






blocked records; not pre- 






ceded by a GET FILE, 






DEFER 


2,747 


879 


b. GET FILE following a GET 






FILE,DEFER; file consists 






of unblocked records 


1,274 


408 


c. Additional time for a GET 






FILE if file consists of 






blocked records 


486 


155 


d. Additional time for a GET 






FILE if file is on IBM 1301 






Disk 


683 


228 


GET FILE,DEFER 


2,322 


743 



INPUT/OUTPUT FUNCTIONS 

1. Service an interrupt due to the 
completion of an overlapped op- 
eration; no error conditions; an- 
other lORW is added to a file list 
( Note 3 and Note 4 ) 

2. Start a pending operation and re- 
turn to an interrupted instruction 
( Note 3 ) , where 

u — not overlapped 

o — overlapped 
To start SEEK operation, non- 
sequential 

Additional time to start SEEK 
operation, full-track sequential 
5. To start input/output operation 
after detecting SEEK complete 
interrupt 



TIMING IN MICROSECONDS 
IBM 1410 IBM- 7010 



2,075 



851 u 
549 o 



648 



277 u 
173 



3. 



4. 



l,470-f50M 560-M6M 



890 



1,450 -f50M 
-1-50n 



300 



555-f-16M 
-t-16n 



820-f-50p 350-fl6p 



Additional time to start input/ 
output operation if another mod- 
ule, having a higher priority, has 
a SEEK pending 
In the module table: 

M = Total number of modules on same channel, 
n = Placement of object module in module table as deter- 
mined by the DSKDF macro-instruction (for module 
00, n = 1; for module 01, n = 2; etc.) 
p = Placement of module with SEEK pending in module 
table as determined by the DSKDF macro-instruction 
(for module 00, p = 1; for module 01, p = 2; etc.) 



SHARED DISK FILE CONSIDERATIONS 



TIMING IN MICROSECONDS 
IBM 1410 IBM 7010 



1. Additional time for any tape I/O 
operation if shared-file IOCS is 

generated. 270 104 

2. Additional time for any disk I/O 
operation if shared-file IOCS is 

generated. 955 484 

Note 1: The times listed for the scheduling functions are 
generally overlapped with respect to all channels. 

Note 2: If a GET or PUT must move a data record, add 
the time required for the move to the times listed. 

Note 3: These times are not overlapped with respect to the 
channel being serviced except for SEEK operations in process. 

Note 4: Additional time required to service an interrupt 
if SPOOL was specified at System Generation time is 146 micro- 
seconds for IBM 1410 and 48 microseconds for IBM 7010. 
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Index 



ADD card (Class rv) 47 

ALTUB card (Class iv) 47 

Assignment symbols for initial run 

Disk system 50 

Tape system 49 

Autocoder compiler modules 54 

Autocoder creation chart 60 

Basic concepts 

Disk-oriented system 16-22 

Tape-oriented system 10-15 

Basic Resident Monitor 

Disk system Master file 51 

Tape system Master file 50 

Building a library 

Disk 26 

External to a tape sof 24 

Part of a tape sof 24 

Check list for System Generation 

Disk-oriented 21 

Tape-oriented 14 

Class I control card— The incld Card 45 

Class II control cards— Macro Library 45 

Class III control cards— Create Library 46 

Class IV control cards— Relocatable Library 47 

COBOL 

Compiler modules 55 

Creation chart 60 

Object-time modules 53 

Relocatable Library modules 

for object programs 59 

Comments card for sg3 program 84 

Complete system creation chart 64 

Concepts of System Generation, general 6 

Contents of the libraries 52 

Control card classes 48 

Class I 45 

Class n 45 

Class III 46 

Class IV 47 

Control cards 

Linkage Loader for System Generation 44 

Monitor for sgI and sg2 44 

Pseudo Monitor 77,76 

SG 45 

sg3 creation chart ,.. 63 

sg3 program 63, 81 

sg5 program 76-80 

System description 36 

System Generation 45 

Copy card 82 

Core-storage requirements 

Nonresident 88 

Operating system 87 

Optional Resident Monitor (for tp) 88 

GREAT card (Class iii) 47 

Create Library 47 

Contents 55 

Control cards 46 

Maintenance 72 

Creation charts 

Use of 57 

Data files on disk storage, organization of 23 



Data flow during System Generation runs 32 

Definitions 6 

DELET card 

Class n 46 

Class III 46 

Class IV 48 

DEVDF macro 41 

Device definitions for Resident iocs (devdf) 41 

Diagnostic messages 

for Disk Library Load program 71 

for Disk Load program 69 

for sgI and sg2 

Disk-oriented system 72 

Tape-oriented system 71 

for sg3 86 

for sg4 75 

for sg5 78-80 

Disk areas ( gen03-gen06 ) 38 

Disk definitions for Resident iocs (dskdf) 42 

Disk library loader (dsklibldr) 

Console messages 70 

Creation chart 64 

Disk Load Program 68 

Console messages 69 

Disk-oriented system 16-22 

Basic concepts 16 

Definition of 16 

Machine requirements 5,8 

Maintenance considerations 21 

Over-all data flow 34 

sgI and sg2 diagnostic messages 71 

Disk Relocatable Library considerations 25, 73 

Disk Sort Definition Program 

Creation chart 63 

Program modules 53, 63 

Disk Sorting Program 

Machine requirements 9 

Relocatable Library modules 63 

Disk storage, formatting 23 

DSKDF macro 42 

edit Control cards 77-78 

edit Option 76 

exeq card 30 

File Organization System 

Creation chart for System Definition 63 

Monitor definitions for, (gen08 statement) 39 

Optional Resident Monitor requirements for 88 

Relocatable library modules 52 

System Definition program 49,50,64 

Form G files 23 

FORTRAN 

Compiler modules 55 

Creation chart 62 

Object-time modules 53 

Relocatable Library modules for object programs 62 

genOI macro 37 

gen02 macro 37 

gen03-gen06 macros , 38 

gen07 macro 38 

gen08 macro 39 

gen09 macro 40 

genIO macro 41 

genII macro 41 
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GENER card (Class m) 46 

GENRM macro 43 

History file 

Maintaining with the sg3 program 84 

UPDAT optional procedure 82 

HR identifier 23 

IBM 1311 disk drives 

Basic Resident Monitor requirements for 88 

Nonresident requirements 89 

IBM 1311 Disk Label Program, creation chart 64 

iNCLD card, Class i 45 

iNSER, card 

Class II 45 

Class in 46 

Class IV 47 

Insert/Delete card 84 

IOCS definitions (iokdf) 42 

IOCS timing estimates 89 

IOKDF raacro 42 

Libraries, contents of 52 

Library 

Building as part of tape sof 24 

Building external to a tape sof 24 

Building for disk 26 

Definition 6 

Disk 26 

Maintaining for disk 26,72 

Maintaining for tape 25,72 

Maintaining on tape sof 24,72 

Maintenance, functions and control cards 47,73 

Linkage Loader 

Auxiliary creation chart for tp 59 

Control cards for System Generation 44 

Creation chart 57 

Modules 54 

Literature, prerequisite and related 5 

Loader modules for ptc programs 55 

LOCAT card 45 

Class II 45 

Class III 46 

Class IV 47 

Machine requirements 5, 7-8 

Disk-oriented systems 5, 7 

Disk sorting program, generalized 9 

Operating system, tape-oriented 8 

Operating system, 1301 disk-oriented 8 

Operating system, 2302 disk-oriented 9 

sg4 74-75 

sg5 76 

SPOOL feature 9 

System Generation 5 

Tape-oriented systems 8 

Tape sorting program, generalized 9 

Tele-processing system 9 

Macro Library 

Contents 52 

Control cards 45 

Maintenance of 73 

Macro Print and Punch modules 55 

Macro Print and Punch program 30 

Creation chart 64 

Maintaining a disk library 26 

Maintaining a tape library 25 

Maintaining the History file with the sg3 program 81 

Maintaining the System 73-80 

Maintenance considerations 

Disk system 21 

Tape system 14 

Master file 

Definition 6 



Disk-oriented system 7, 50 

Tape layout 32 

Tape-oriented system 7, 49 

Master tape load program creation chart 64 

Modification Tape 73-74 

Monitor 

Control cards for sgI and sg2 45 

Control cards for sg5 76-79 

Creation chart (for Tele-processing system) 59 

Definition 6 

Definitions (gen08) 39 

Modules in Relocatable Library 58 

Monitors with Tele-processing capabilities 29 

Nonresident core-storage requirements 88 

OMIT option 76 

OMIT option control cards 78 

Operating section 6 

Operating System, 1410/7010 

Core-storage requirements 87 

Machine requirements 5,8 

Over-all data flow, tape system 32 

Over-all data flow, disk system 34 

Prerequisite and related literature 5 

PRINT card 31 

Programs available 

Disk system Master file 50 

Tape system Master file • 49 

Pseudo Monitor control cards 77 

Purpose of System Generation 5 

Purpose of this publication 5 

Random-processing disk module definitions 43 

Random-Processing Scheduler 29 

Modules 53 

Record address (disk) 23 

Relocatable libraries 24 

Relocatable Library 

Contents 52 

Control cards 47 

Maintenance of 73 

REPLC card 45 

Class 11 45 

Class m 46 

Class IV 48 

Reserve units (gen09) 40 

Resident Monitor 51, 53 

Core-storage requirements for tp 88 

( Optional ) 

Modules 54 

Restart program creation chart 58 

Revision letter (History file) 82 

Sequence number (History file) 82 

Sequence number (sg4 and sg5) 74,77 

sg control card classes, group of 48 

SG control cards 45 

sgI and sg2 

Diagnostic messages 

Disk-oriented system 72 

Tape-oriented system 71 

Program creation charts 63, 64 

sg3 diagnostic messages 86 

sg3 program 

Comments for 84 

Creation chart 64 

Maintaining History file with 85 

sg4 Program 

Creation chart 64 

Maintaining Libraries with 74-75, 73 

sg5 Program 

Creation chart 64 

Maintaining Libraries with 76-80, 73 
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SGF 

Building for a disk-oriented system 16 

Building for a tape-oriented system 10 

Generation, example of 65 

Modification, example of 66 

Tape layout 32 

Shared Disk Files 20 

General information 20 

Specification in dskdf macro 41 

SOF 

Building for a disk-oriented system 19 

Building for a tape-oriented system 12 

Generation, example of 65 

Tape layout 31 

Sort Definition program, disk 27,63 

Sort Definition program, tape 27,52,63 

SPLDF macro 36 

SPOOL feature 36 

Definition of 9 

Machine requirements 9 

Optional Resident Monitor requirements for 88 

Specification of 36 

System Definition, File Organization System 49,50,64 

Creation chart 64 

System description control cards 28,36 

System Generation 

Check list for disk-oriented 21 

Check list for tape-oriented 14 

Concepts, general 5 

Considerations 23 

Control cards 44-48 

Data flow during 32 

Linkage Loader control cards 44 

Machine requirements 5 

Purpose of 5 

Tape system, examples for a 63 

System Generator File (sgf) 6 

System Generator modules 55 

System Maintenance 73-80 



System Monitor creation chart 58 

System Operating File (sof) 12, 19 

Tape layout, Master file, sgf and sof 32 

Tape-oriented system 7, 10-15 

Basic concepts of 10-15 

Definition of 6 

Machine requirements 5, 8 

Maintenance considerations 14 

sgI and sg2 diagnostic messages 71 

Tape Sort Definition program 26 

Creation chart 63 

Program modules 52 

Tape sorting program 

Machine requirements 9 

Relocatable Library modules 63 

Tape system, over-all data flow 32 

Tape-to-disk sof load modules 55 

Tape units (gen02) 37 

Tele-processing system 

Library Generator modules 55 

Machine requirements 9 

Monitor creation chart 61 

Monitors for 29 

Supervisor modules 54 

Units (genII) 41 

Timing estimates for iocs 89 

TLiB card 78 

Track number 23 

Transitional Monitor modules 54 

Unit-record devices (genOI) 37 

UPDAT card 83 

UPDAT optional procedure for History file 83 

Updating libraries 73 

User-written program, addition of 13 

Utility program 

Creation chart 63 

Modules 52, 55 

Work units (genIO) 41 
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with FORTRAN Subprograms, the relocatable modules 
required to run with cobol and Fortran object pro- 
grams must be in the same Relocatable Library. 

9. Every system must have the Bootstrap, the Resi- 
dent Monitor, and the Transitional Monitor (in that 
order) at the beginning of the tape. 

10. The maximum number of items that may appear 
on an sof is 154. An item is defined as a program or a 
library. (Examples: cobol is one item and ibmlibr is 
one item. ) 

11. Table 1 indicates the asgn cards that are required 
during System Generation. 

12. The Generalized Tape Sorting Program requires 
a minimum of four tape units (including the sof). 



These may be the same tape units as those used as 
work files by compilers. Additional tape units increase 
the program's efficiency. See the publication General- 
ized Tape Soiiing, Program. 

13. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 

14. Programs that require the Autocoder "No-Clear" 
option for da statements must not be placed on the sof. 

15. Programs on the sof cannot contain a phase in- 
tended to modify, through loading from the sof, a 
previous phase. 



Table 1. Tape System Input/ Output Requirements 
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Input File 
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From 
Autocoder 
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DEFINE 




Linkage 
Loader 
Input File 
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LINKLOAD 


Library 
Directory 
Work File 


Linkage 
Loader 
Input File 
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From 
Autocoder 
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Library 
Directory 
Work File 
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put File) 
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Directory 
Work File 



For the minimum configuration, MW3 and MJB, and MGO and MRO share the same physical units 
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Basic Concepts — Disk-Oriented System 



This section applies only to a disk-oriented system and 
need not be read by persons interested only in a tape- 
oriented system. 



How ffie System is Built 



The output, in absolute form, is placed onto the 
Job file, MjB. 

SG2: This program locates and copies the library 
elements that the user desires in the new system. Its 
output is a new tape that is capable of being loaded 
onto the disk. This tape contains all items generated. 



Functions to be Performed 

The Master file contains a bootstrap disk load program 
that loads the Master file on the disk in preparation 
for System Generation. The absolute portion that is 
loaded on the disk is capable of building an sgf. The 
SGF incorporates those options desired by the user. To 
build the sgf, several programs from the operating 
section, which are in absolute format, are executed. 
These programs perform the following functions: 

1. Accept input data that describes the environment 
within which the new system is to operate, and in- 
corporate the optional items defined by each user. 

2. Build absolute programs that the user specifies. 

3. Place these absolute programs on the output file. 

4. Place the library elements on the output file. 

Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and the various options available in the 
form of Autocoder source statements. Autocoder proc- 
esses this input by means of macro routines and gen- 
erates the nucleus of the new system. 

SGI: This program performs one function. It pre- 
pares a tape which contains input control information 
for the Linkage Loader (linkload program). 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 
work tape produced by SGi and/or control cards from 
the siu. The relocatable input that it processes comes 
from: 

1. The output of the Autocoder run (item 1 above); 
and 

2. The Relocatable Library supplied on the Master 
file. (This library must have been loaded onto the 
disk.) 



Defining the System 

The user must describe the Operating System that he 
desires through control cards. A detailed description 
of the control cards appears in "System Description 
Control Cards" and "System Generation Control 
Cards." 

Briefly, the user supplies the following: 

1. The number and types of input/output devices. A 
two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic unit entries 
required. 

4. The variable and optional features desired within 
the Resident iocs. 



Preparing to Build an SGF 

Before building an sgf or sof, it is necessary for the 
user to load the Master file or the source sgf onto disk 
storage. Instructions for performing this transfer to 
disk storage are given in "Disk Load Program." 

After the Master file is loaded onto the disk, it is 
necessary to format the disk areas required for the 
files (mjb, mgo, MWi, MW2, and mw3) used during 
System Generation. This is accomplished by using the 
1301 or 2302 Format/ Address Generator utility pro- 
grams. See the publication IBM 1410/7010 Operating 
System; Utility Programs, Form C28-0353, for instruc- 
tions in the use of these programs. 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
sgf run. 
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General Maintenance Considerations 

Maintenance of the Operating System covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the SGF, SOF, all Job files that have been saved, 
and all tp Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of affected modules, 
copying (incld) any unaffected programs, and re- 
generation of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating section which 
were affected. As in above item, any unaffected pro- 
grams can be copied by use of the incld card. By care- 
ful planning, the user should be able to make changes 
to an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions of the operation 
of the Go file during maintenance of the Relocatable 
Library. Refer to Class iv control cards inser and 
REPLC, under "System Generation Control Cards." 

Instead of the above method, the sg4 and SGr> pro- 
grams can be used to update the libraries, as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm svipplies a tape 
containing the changes to be made. This tape is used 
with the SG5 program to prepare an input tape for up- 
dating the libraries. The program has an option that 
permits it to be used with a minimum disk system 
having only one tape unit available to the Operating 
System program. If the user must make his own 
changes to ibm program modules, he can use the sg4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities effi- 
ciently, i 

Check List for System Generation 
(Disk-Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The Sort Definition program should be gener- 
ated by the initial generation if sort or merge programs 
are to be created on an sof. 

3. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 



Relocatable Library can also be modified. The library 
must be loaded onto the lib file when the system is 
loaded on the disk. 

4. COBOL and Autocoder use symbolic units mwi, 
MW2, and MW3 for work files during compilation; For- 
tran uses Mwi and mw2. mwi and mw3 should be 
assigned to a different channe^l and/or module from 
MW2 for balanced and efficient usage of the 1301 disk. 

5. The Create Library must be named creatlib, and 
the Macro Library must be named macrolib, 

6. If the COBOL "enter" verb is used in conjunction 
with FORTRAN Subprograms, the relocatable subpro- 
grams required to run with cobol and Fortran object 
programs (refer to "Relocatable Library Contents") 
must be in the same relocatable library. 

7. The order of elements on the disk is of little im- 
portance because of the random access nature of the 
device. However, the placement of some of the ele- 
ments on the output tape, which contains the system, 
can he critical, and the following points should be 
observed: 

a. The first program on the tape must be ibsgdl. 
This is the Disk Load program. 

b. The second program must be ibboot. ibboot, 
for a disk-oriented system, comprises a boot- 
strap program (ibbootsd), the Resident Moni- 
tor, and the Transitional Monitor. 

c. The remaining programs may be in any order 
if they have been included from an existing 
sgf. If the system that is being built is to be 
capable of generating another system, ibsgdl 
must be included again. 

d. If an entire system is being generated, ibsgdl 
must be generated as the first program. Also, 
if the entire system being generated is to be 
capable of generating another system, then the 
ibsgdl program must also be generated last. 

8. Table 2 indicates the asgn cards that are required 
during System Generation. 

9. The Generalized Tape Sorting program requires 
a minimum of four tape units (including the sof). 
Additional tape units increase the program's efficiency. 
See the publication Generalized Tape Sorting Pro- 
gram. 

10. Each initialization of a disk system requires that 
the BOOTi card be first in the siu. The contents of this 
card are typed on the console printer during system 
loading. The operator key punches the card and places 
it in the siu. 

11. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
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requirements for the system. See the pubheation Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 

12. Programs that require the Autocoder "No-Clear" 



oi^tion for da statements should not be placed on the 



SOF. 



13. Programs on the sof cannot contain a phase in- 
tended to modify, through loading from the sof, a 
previous phase. 



Table 2. Disk System Input/ Output Requirements 



Physical Unit 


1 


2 


3 


4 


5 


6 


7 


8 


9 


Symbolic Unit 


SOF 


SIU 


MWl 


MW2 


MW3 


MJB 


MGO 


LIB 


SPR 


c 
o 

•- 's 

-O (U 
4) C 
.!" <U 

E^ 
o E 

2 >L 


Autocoder 


1 
a 

1 


I 

a 
I 

r 


i 

\ 

a 


J 
J 

f 

1 


Work File 


Work File 


Work File 




Output 




1 1 

"o 

c 
_o 

Q. 
O 


SGI 




* Linkage 
Loader 
Input File 






Not 
Used 




SORT- 
DEFINE 




*Linkage 
Loader 
Input File 






Not 
Used 




LINKLOAD 


■f 


*Linkage 
Loader 
Input File 




Output 


From 
Autocoder 


Input 


SG2 




*New 
SOF 




Input 


Possible 
Input 


Input 



Must be a tape unit. 
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AUTOCODER 


Work Files and 
Go Files on 


Ta^e 


X 


r X 






Disk 






X 


X 


Processor 
Resides on 


Tape 


X 




X 




Disk 




X 




X 


Create Packet Name 


TAUTOCODE 






DAUTOCODE 


6 16 21 

001 PHASE AUTOCODER 
CALL IBAU10COMM 
CALLN IBAUIOINPT 
CALL IBAU10TPE1 
CALL IBAU10TPE2 
CALL IBAU10DSK1 
CALL IBAU10DSK2 
CALL IBAU10DSK3 
CALL IBAU10IOTB 


X 
X 
X 
X 
X 

X 


X 
X 
X 
X 

X 
X 


X 
X 
X 

X 

X 
X 


X 
X 
X 

X 
X 

X 


61 
010 PHASE 3 

62 
015 PHASE M 


X 
X 


X 


X 
X 


X 


020 PHASE 

CALLN IBAU20GENR 
CALL IBAU20TPE1 
CALL IBAU20TPE2 
CALL IBAU20DSK1 
CALL IBAU20DSK2 
CALL IBAU20DSK3 


X 
X 
X 
X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


030 PHASE 

CALLN IBAU30ASGN 
CALL IBAU30SCAN 
CALL IBAU30TPE1 
CALL IBAU30DSK1 
CALLN IBAU30SUBR 


X 
X 
X 
X 

X 


X 
X 
X 
X 

X 


X 
X 
X 

X 
X 


X 
X 
X 

X 
X 


033 PHASE 

CALLN iBAU33SUBR 
CALL IBAU33TPE1 
CALL IBAU33DSK1 
CALLN IBAU33,RCUR 


X 
X 
X 

X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


040 PHASE 

CALLN IBAU40OTPT 
CALL IBTOCGM 
CALL IBDOCGM 
CALL IBTPCGM 
CALL IBDPCGM 
CALL IBTCCGM 
CALL IBDCCGM 
CALL IBTNCGM 
CALL IBDNCGM 
CALLN IBAU40TPE1 
CALLN IBAU40DSK1 


X 
X 
X 

X 

X 

X 

X 


X 
X 
X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


050 PHASE 

CALL IBAU50TPE1 
CALL IBAU50DSK1 
CALLN IBAU50CREF 


X 
X 

X 


X 
X 

X 


X 

X 
X 


X 

X 
X 



* To insert Directory 3 
** To insert the Macro Library 

NOTE: The Macro Library cannot be placed on a Job file. 



COBOL: Relocatable Library Modules for Object 
Programs 

The following modules are required by cobol object 
programs : 

IBCOBOL 

IBCBLADOVR 

IBCBLDSPLY 



IBCBLCMPAR 

IBCBLFLDMP 

IBCBLALTST 

IBCBLSUBSC 

IBCBLACCPT 

IBCBLEXPON 

IBCBLRDINT 

IBCBLDVZER 

IBCBLCLEAR 



Creation Charts 61 



FORTRAN: Relocatable Library Modules for Object 
Programs 

Required Modules 

The following modules are required to run with any 
FORTRAN object program: 



IBCOMMON 


IBINDX2 


IBBACKSP 


EXP 


IBLABEL 


IBINDX3 


IBENDFILE 


ALOG 


IBFOERR 


IBEXPFF 


IBREWIND 




IBINTRP 


IBEXPFI 


FLOAT 




IBINDXl 


IBEXPII 


IFIX 





Optional Modules 

The following modules are not required by a Fortran 
program unless they are called by name in the source 
program. Inclusion of these modules is therefore an 
installation option, except (as noted) the selection 
of one optional module may require another. 



ABS 




DIM 


AINT 




DVCHK 


AMAXO 




EXIT 


AMAXl 




lABS 


AMINO 




IDIM 


AMINl 




INT 


AMOD (requires AINT) 


ISIGN 


ATAN 




MAXO 


COS (requires 


SIN) 


MAXl 



MINO 

MINI 

MOD 

OVERFL 

SIGN 



SIN 

SLITE (requires SLITET) 

SLITET 

SQRT 



Floating-Point Arithmetic Modules 

The four modules supporting floating-point arithmetic 
are on the Relocatable Library of the Master file in 
the following order: 

POSITION NAME REMARKS 

1 IBINTRP For programmed interpretation of 

floating-point instructions. 

2 OVERFL ~i For machine interpretation of 

3 DVCHK y floating-point instructions ( on an 

4 IBINTRP J IBM 7010 with the Floating-Point 

Arithmetic feature ) . 

To obtain the modules supporting the 7010 Float- 
ing-Point Arithmetic feature, the following card should 
be used: 

6 16 21 

IBINTRP DELET R 

To obtain the modules that provide programmed 
interpretation for floating-point instructions, use this 
card: 

6 16 21 

OVERFL DELET R,IBINTRP 



FORTRAN 


Work Files on 


Tape 


X 


. X 






Disk 






X 


X 


Go File on 


Tape 


X 




X 




Disk 




X 




X 


Create Packet Name 


TFORTRAN 






DFORTRAN 


16 21 










PHASE FORTRAN 


X 


X 


X 


X 


CALLN IBFTNCMN 


X 


X 


X 


X 


CALL IBFTN05TO 


X 


X 






CALL IBFTNOSDO 






X 


X 


CALLN IBFTN05 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASEl FCMN/ 


X 


X 


X 


X 


CALL IBTPCGM 


X 




X 




CALL IBDPCGM 




X 




X 


CALL IBTCCGM 


X 




X 




CALL IBDCCGM 




X 




X 


CALL IBTNCGM 


X 




X 




CALL IBDNCGM 




X 




X 


CALLN IBTOCGM 


X 




X 




CALLN IBDOCGM 




X 




X 


CALL IBFTN10TO 


X 


X 






CALL IBFTN10DO 






X 


X 


CALL IBFTN10TI 


X 


X 






CALL IBFTN10DI 






X 


X 


CALLN IBFTN10 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASEl MOCG/ 


X 


X 


X 


X 


CALL IBFTN20TO 


X 


X 






CALL IBFTN20DO 






X 


X 


CALL IBFTN20TI 


X 


X 






CALL IBFTN20DI 






X 


X 


CALLN IBFTN20 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASEl MOCG/ 


X 


X 


X 


X 


CALL IBFTN25TI 


X 


X 






CALL IBFTN25DI 






X 


X 


CALLN IBFTN25 


X 


X 


X 


X 
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SGI and SG2 Diagnostic Messages 



The SGI and sg2 diagnostic messages are listed in this 
section with an explanation of the message and sug- 
gested corrective action for: (1) tape-oriented systems, 
and (2) disk-oriented systems. 



Tape-Otiented System 

Diagnostic messages that may be produced on the con- 
sole printer during execution of sci and scs are listed 
in sequence by message number in the following sec- 
tion. When one of these messages appears, processing 
halts and special end of program occurs unless the 
"Corrective Action" comment states that processing 
will continue or that no corrective action is to be taken. 
After the correction is made, the job must be rerun. 
Full instructions appear in the publication, Operators 
Guide. 

SGI and SG2 Diagnostic Messages for a Tape-Oriented 
System 

11501 XXXXXXXXXX NOT ON TAPE 

Explanation: Request has been made for the named 
item but it cannot be located on the SOF or on the 
Relocatable or Create Library. 

Corrective Action: Check control deck for proper call 
and/or spelling, etc. 

11502 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number has 
been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11503 DIRECTORY X NOT AVAILABLE 
Explanation: X can be "1" or "3." 

Corrective Action: Cheek the control deck to make sure 
directory has been generated previous to this reference. 
If X is not 1 or 3, the PHASE card for the directory has 
been mispunched. 

11504 XXXXXXXXXX LIBRARY NOT AVAILABLE 
Explanation: Request has been made for the named 
library but that library cannot be located or does not 
exist. 

Corrective Action: Check the control deck to make sure 
that a library of the name XXXXXXXXXX has been 
copied, updated, or added by SGI. 

11505 NEW SOF ON XXX 

Explanation: XXX is the x-control field for the unit 
on which the System Generation output file is located. 
Corrective Action: None. 

11507 LIB TYP UNKNOWN 

Explanation: Request has been made for a library 
whose type is not M, R, or C. 

Corrective Action: Check control deck. The PHASE 
card for the library header may have been punched 



incorrectly. The M, R, or C must be in column 62 of 
the PHASE card. 

11508 BACKSPACE FAILURE - SOF 
Corrective Action: Restart. 

11509 BACKSPACE FAILURE - MJB 
Corrective Action: Restart. 

11510 NEW LIBRARY ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new library is located. 
Corrective Action: None. 

11511 UNKNOWN HDR TYP 

Explanation: Header record is not proper format. 
Corrective Action: Check control deck. Check that all 
the libraries processed by SGI were done in one block 
and were processed before absolute programs. Also 
check that no conflict exists in input/output assignments. 

11512 NO TYPC COUNTS 

Explanation: Specific cause has not been determined. 
Corrective Action: Check control deck for extraneous 
PHASE cards, order of cards, etc. 

11513 EXTRANEOUS HEADER 

Explanation: Record descriptions contained on MWl 
(header records) do not agree with contents of Job file. 
Corrective Action: Ensure that all requests for SGI to 
INSER, DELET, REPLC, and ADD library material 
were made prior to requests to process absolute format 
records. Also check that no conflict exists in input/out- 
put assignments. 

11514 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11515 MODULE XXXXXXXXXX NOT ON GO TAPE 

Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 
Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11516 SOF RECORD TOO LARGE TO COPY 

Explanation: SGI, when working with largest possible 
records, cannot copy an SOF on a smaller machine than 
was used to generate the SOF. 

Corrective Action: The records on the SOF cannot be 
copied on the size machine being used, with SGI based 
where it is. Regeneration of the SOF is necessary. 

11517 NO ALTERNATE LIBRARY HEADER 

Explanation: SGI has been directed to find an external 
library, but did not find an identifying header record 
on LIB. 

Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11518 (No message) 

Explanation: A macro routine or a model statement has 
been specified, but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SGI may be out of sequence. 
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11519 MACRO DIR EXCEEDS 240 

Explanation: The Macro Library can have only 240 
entries, and this number has been exceeded. 
Corrective Action: Reduce number of macro routines to 
specified limit. 

11520 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were followed 
by an END card. No action is required if all other cards 
are in order. 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates 
a header is desired on the output tape. The card follow- 
ing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2." 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11523 SOF EXCEEDS 154 LIMIT 

Explanation: Tape SOF may have no more than 154 
items, and this number has been exceeded. 
Corrective Action: Deck may be in error. Some items 
may have been copied several times. 

Dlsk-Oriented System 

Diagnostic messages that may be produced on the 
console printer during execution of sgi and sgs are 
listed in sequence by message number in the follow- 
ing section. When one of these messages appears, 
processing halts and special end of program occurs 
unless the "Corrective Action" comment states that 
processing will continue or that no corrective action 
is to be taken. After the correction is made, the job 
must be rerun. Full instructions appear in the Oper- 
ator's Guide. 

SGI and SG2 Diagnostic Messages for a Disk-Oriented 
System 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates a 
header is desired on the output tape. The card fol- 
lowing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2". 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11562 CREATLIB NOT ON SOF 

Explanation: SGI has been executed, but the Create 
Library is not on the system. 

Corrective Action: An SOF that includes the Create 
Library must be generated and this SOF used to proc- 
ess the job that caused the message. 

11563 PACKAGE XXXXXXXXXX NOT IN CREATLIB 
Explanation: No packet of the name XXXXXXXXXX 
has been found in the Create Library by SGI. 



Corrective Action: Check the control deck to be sure 
that spelling on GREAT card is correct. 

11564 OUTPUT ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new output file is located. 
Corrective Action: None. 

11565 DISK LOADER NOT PRESENT 

Explanation: IBSGDL has not been included or gener- 
ated as the first item. 
Corrective Action: Rerun the job including IBSGDL. 

11566 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were fol- 
lowed by an END card. No corrective action is neces- 
sary if all other cards are in order. 

11567 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

11568 (No message) 

Explanation: A macro routine or a model statement has 
been specified but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SG2 may be out of sequence. 

11569 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number 
has been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11570 ALTERNATE LIBRARY HEADER 

Explanation: SG2 has been directed to find a library 
but did not find an identifying header record on LIB. 
Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11571 MODULE XXXXXXXXXX NOT ON GO FILE 

Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 
Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11572 XXXXXXXXXX NOT AVAIL 

Explanation: An INCLD card has specified the name 
of an item which is not in the system. 
Corrective Action: Check control deck for proper spell- 
ing of item name. 

11573 XXXXXXXXXX NOT VALID 

Explanation: An INCLD card has specified the name 
of an item which does not contain valid program infor- 
mation. The area assigned to SOF (on the disk) has 
been accidentally altered or destroyed. 
Corrective Action: Reload the SOF from the output tape 
from the previous System Generation run. 

1 1 574 SG2 CTL CARD OR I / O ERROR 

Explanation: An uncorrectable I/O error has occurred. 
The problem may be caused by erroneous system gener- 
ation control cards. 
Corrective Action: Check the deck and rerun. 
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